XmlDocument.Load Method (System.Xml) (2024)

Loads the specified XML data from a Stream, a URL, a TextReader, or an XmlReader.

Source:

XmlDocument.cs

Source:

XmlDocument.cs

Source:

XmlDocument.cs

public: virtual void Load(System::IO::Stream ^ inStream);

public virtual void Load (System.IO.Stream inStream);

abstract member Load : System.IO.Stream -> unitoverride this.Load : System.IO.Stream -> unit

Public Overridable Sub Load (inStream As Stream)

Parameters

Exceptions

Remarks

If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. For more information, see the Remarks section of the XmlReader reference page.

This method is a Microsoft extension to the Document Object Model (DOM).

This method automatically detects the string format of the input XML (for example, UTF-8, ANSI, and so on). If your application needs to know which encoding is used to read the stream, consider using an XmlTextReader object to read the stream, and then use the XmlTextReader.Encoding property to determine the encoding. If you need to use a XmlDocument object to work with XML, you can use the XmlTextReader object to create one. For more information, see Reading XML Data using XPathDocument and XmlDocument.

See also

• ValidationEventArgs
• XmlSeverityType
• Schemas

Source:

XmlDocument.cs

Source:

XmlDocument.cs

Source:

XmlDocument.cs

public: virtual void Load(System::IO::TextReader ^ txtReader);

public virtual void Load (System.IO.TextReader txtReader);

abstract member Load : System.IO.TextReader -> unitoverride this.Load : System.IO.TextReader -> unit

Public Overridable Sub Load (txtReader As TextReader)

Parameters

Exceptions

Examples

The following example uses the StringReader class to load a string of XML data into the XmlDocument object.

#using <System.Xml.dll>using namespace System;using namespace System::IO;using namespace System::Xml;int main(){ // Create the XmlDocument. XmlDocument^ doc = gcnew XmlDocument; String^ xmlData = "<book xmlns:bk='urn:samples'></book>"; doc->Load( gcnew StringReader( xmlData ) ); // Create a new element and add it to the document. XmlElement^ elem = doc->CreateElement( "bk", "genre", "urn:samples" ); elem->InnerText = "fantasy"; doc->DocumentElement->AppendChild( elem ); Console::WriteLine( "Display the modified XML..." ); doc->Save( Console::Out );}

using System;using System.IO;using System.Xml;public class Sample { public static void Main() { // Create the XmlDocument. XmlDocument doc = new XmlDocument(); string xmlData = "<book xmlns:bk='urn:samples'></book>"; doc.Load(new StringReader(xmlData)); // Create a new element and add it to the document. XmlElement elem = doc.CreateElement("bk", "genre", "urn:samples"); elem.InnerText = "fantasy"; doc.DocumentElement.AppendChild(elem); Console.WriteLine("Display the modified XML..."); doc.Save(Console.Out); }}

Imports System.IOImports System.Xmlpublic class Sample public shared sub Main() ' Create the XmlDocument. Dim doc as XmlDocument = new XmlDocument() Dim xmlData as string = "<book xmlns:bk='urn:samples'></book>" doc.Load(new StringReader(xmlData)) ' Create a new element and add it to the document. Dim elem as XmlElement = doc.CreateElement("bk", "genre", "urn:samples") elem.InnerText = "fantasy" doc.DocumentElement.AppendChild(elem) Console.WriteLine("Display the modified XML...") doc.Save(Console.Out) end subend class

Remarks

If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. For more information, see the Remarks section of the XmlReader reference page.

This method is a Microsoft extension to the Document Object Model (DOM).

See also

• StreamReader
• ValidationEventArgs
• XmlSeverityType
• Schemas

Source:

XmlDocument.cs

Source:

XmlDocument.cs

Source:

XmlDocument.cs

public: virtual void Load(System::String ^ filename);

public virtual void Load (string filename);

abstract member Load : string -> unitoverride this.Load : string -> unit

Public Overridable Sub Load (filename As String)

Parameters

Exceptions

Remarks

If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. For more information, see the Remarks section of the XmlReader reference page.

This method is a Microsoft extension to the Document Object Model (DOM).

See also

• ValidationEventArgs
• XmlSeverityType
• Schemas

Source:

XmlDocument.cs

Source:

XmlDocument.cs

Source:

XmlDocument.cs

public: virtual void Load(System::Xml::XmlReader ^ reader);

public virtual void Load (System.Xml.XmlReader reader);

abstract member Load : System.Xml.XmlReader -> unitoverride this.Load : System.Xml.XmlReader -> unit

Public Overridable Sub Load (reader As XmlReader)

Parameters

Exceptions

Examples

The following example loads the last book node of the books.xml file into the XML document.

#using <System.Xml.dll>using namespace System;using namespace System::IO;using namespace System::Xml;int main(){ //Create the XmlDocument. XmlDocument^ doc = gcnew XmlDocument; //Load the document with the last book node. XmlTextReader^ reader = gcnew XmlTextReader( "books.xml" ); reader->WhitespaceHandling = WhitespaceHandling::None; reader->MoveToContent(); reader->Read(); reader->Skip(); //Skip the first book. reader->Skip(); //Skip the second book. doc->Load( reader ); doc->Save( Console::Out );}

using System;using System.IO;using System.Xml;public class Sample{ public static void Main() { //Create the XmlDocument. XmlDocument doc = new XmlDocument(); //Load the document with the last book node. XmlTextReader reader = new XmlTextReader("books.xml"); reader.WhitespaceHandling = WhitespaceHandling.None; reader.MoveToContent(); reader.Read(); reader.Skip(); //Skip the first book. reader.Skip(); //Skip the second book. doc.Load(reader); doc.Save(Console.Out); }}

Option ExplicitOption StrictImports System.IOImports System.XmlPublic Class Sample Public Shared Sub Main() 'Create the XmlDocument. Dim doc As New XmlDocument() 'Load the document with the last book node. Dim reader As New XmlTextReader("books.xml") reader.WhitespaceHandling = WhitespaceHandling.None reader.MoveToContent() reader.Read() reader.Skip() 'Skip the first book. reader.Skip() 'Skip the second book. doc.Load(reader) doc.Save(Console.Out) End SubEnd Class

The example uses the file, books.xml, as input.

<?xml version='1.0'?><!-- This file represents a fragment of a book store inventory database --><bookstore> <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0"> <title>The Autobiography of Benjamin Franklin</title> <author> <first-name>Benjamin</first-name> <last-name>Franklin</last-name> </author> <price>8.99</price> </book> <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2"> <title>The Confidence Man</title> <author> <first-name>Herman</first-name> <last-name>Melville</last-name> </author> <price>11.99</price> </book> <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6"> <title>The Gorgias</title> <author> <name>Plato</name> </author> <price>9.99</price> </book></bookstore>

Remarks

If the reader is in the initial state (ReadState =ReadState.Initial), Load consumes the entire contents of the reader and builds the DOM from what it finds.

If the reader is already positioned on some node at depth "n", this method loads that node and all subsequent siblings up to the end tag that closes depth "n". This has the following results.

If the current node and its siblings look like the following:

<!--comment--><element1>one</element1><element2>two</element2>

Load throws an exception because a document cannot have two root level elements. If the current node and its siblings look like the following:

<!--comment--><?process instruction?><!--comment--></endtag>

Load succeeds, but you have an incomplete DOM tree because there is no root level element. Before you save the document, you must add a root level element, otherwise Save will throw an exception.

If the reader is positioned on a leaf node that is invalid for the root level of a document, for example a white space or attribute node, the reader continues to read until it is positioned on a node that can be used for the root. The document begins loading at this point.

If you want validation to occur, you can create a validating XmlReader instance by using the XmlReaderSettings class and the Create method. For more information, see the Remarks section of the XmlReader reference page.

This method is a Microsoft extension to the Document Object Model (DOM).

See also

• ValidationEventArgs
• XmlSeverityType
• Schemas