XmlDocument.Load Methode

Quelle:

XmlDocument.cs

Quelle:

XmlDocument.cs

Quelle:

XmlDocument.cs

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

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

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

Public Overridable Sub Load (inStream As Stream)

Parameter

Ausnahmen

Hinweise

Wenn die Validierung erfolgen soll, können Sie mithilfe der XmlReaderSettings -Klasse und der Create -Methode eine validierungsierende XmlReader instance erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise unter der XmlReader Referenzseite.

Diese Methode ist eine Microsoft-Erweiterung für das Document Object Model (DOM).

Diese Methode erkennt automatisch das Zeichenfolgenformat der Eingabe-XML (z. B. UTF-8, ANSI usw.). Wenn Ihre Anwendung wissen muss, welche Codierung zum Lesen des Datenstroms verwendet wird, erwägen Sie die Verwendung eines XmlTextReader -Objekts zum Lesen des Datenstroms, und verwenden Sie dann die XmlTextReader.Encoding -Eigenschaft, um die Codierung zu bestimmen. Wenn Sie ein XmlDocument -Objekt verwenden müssen, um mit XML zu arbeiten, können Sie das XmlTextReader -Objekt verwenden, um ein Objekt zu erstellen. Weitere Informationen finden Sie unter Lesen von XML-Daten mit XPathDocument und XmlDocument.

Weitere Informationen

• ValidationEventArgs
• XmlSeverityType
• Schemas

Quelle:

XmlDocument.cs

Quelle:

XmlDocument.cs

Quelle:

XmlDocument.cs

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

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

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

Public Overridable Sub Load (txtReader As TextReader)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird die StringReader -Klasse verwendet, um eine Zeichenfolge von XML-Daten in das XmlDocument -Objekt zu laden.

#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.IO
Imports System.Xml

public 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 sub
end class

Hinweise

Wenn die Validierung erfolgen soll, können Sie mithilfe der XmlReaderSettings -Klasse und der Create -Methode eine validierungsierende XmlReader instance erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise unter der XmlReader Referenzseite.

Diese Methode ist eine Microsoft-Erweiterung für das Document Object Model (DOM).

Weitere Informationen

• StreamReader
• ValidationEventArgs
• XmlSeverityType
• Schemas

Quelle:

XmlDocument.cs

Quelle:

XmlDocument.cs

Quelle:

XmlDocument.cs

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

public virtual void Load (string filename);

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

Public Overridable Sub Load (filename As String)

Parameter

Ausnahmen

Hinweise

Wenn die Validierung erfolgen soll, können Sie mithilfe der XmlReaderSettings -Klasse und der Create -Methode eine validierungsierende XmlReader instance erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise unter der XmlReader Referenzseite.

Diese Methode ist eine Microsoft-Erweiterung für das Document Object Model (DOM).

Weitere Informationen

• ValidationEventArgs
• XmlSeverityType
• Schemas

Quelle:

XmlDocument.cs

Quelle:

XmlDocument.cs

Quelle:

XmlDocument.cs

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

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

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

Public Overridable Sub Load (reader As XmlReader)

Parameter

Ausnahmen

Beispiele

Im folgenden Beispiel wird der letzte Buchknoten der books.xml Datei in das XML-Dokument geladen.

#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 Explicit
Option Strict

Imports System.IO
Imports System.Xml

Public 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 Sub
End Class

Im Beispiel wird die Datei books.xmlals Eingabe verwendet.

<?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>

Hinweise

Wenn sich der Reader im Anfangszustand (ReadState =ReadState.Initial) befindet, Load verwendet den gesamten Inhalt des Readers und erstellt das DOM aus dem, was er findet.

Wenn der Reader bereits auf einem Knoten in der Tiefe "n" positioniert ist, lädt diese Methode diesen Knoten und alle nachfolgenden gleichgeordneten Elemente bis zum Endtag, das die Tiefe "n" schließt. Dies hat die folgenden Ergebnisse.

Wenn der aktuelle Knoten und seine gleichgeordneten Knoten wie folgt aussehen:

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

Load löst eine Ausnahme aus, da ein Dokument nicht über zwei Elemente auf Stammebene verfügen kann. Wenn der aktuelle Knoten und seine gleichgeordneten Knoten wie folgt aussehen:

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

Load erfolgreich ist, aber Sie verfügen über eine unvollständige DOM-Struktur, da kein Element auf Stammebene vorhanden ist. Bevor Sie das Dokument speichern, müssen Sie ein Element auf Stammebene hinzufügen. Andernfalls Save wird eine Ausnahme ausgelöst.

Wenn der Reader auf einem Blattknoten positioniert ist, der für die Stammebene eines Dokuments ungültig ist, z. B. ein Leerzeichen oder Attributknoten, wird der Reader weiterhin gelesen, bis er auf einem Knoten positioniert ist, der für den Stamm verwendet werden kann. Das Dokument beginnt an dieser Stelle mit dem Laden.

Wenn die Validierung erfolgen soll, können Sie mithilfe der XmlReaderSettings -Klasse und der Create -Methode eine validierungsierende XmlReader instance erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise unter der XmlReader Referenzseite.

Diese Methode ist eine Microsoft-Erweiterung für das Document Object Model (DOM).

Weitere Informationen

• ValidationEventArgs
• XmlSeverityType
• Schemas