Teilen über

XmlDocument.Load Methode

  • Referenz

Definition

Namespace:
System.Xml
Assemblys:
System.Xml.dll, System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Lädt die angegebenen XML-Daten aus einem Stream, einer URL, einem TextReader oder einem XmlReader.

Überlädt

Load(Stream)

Lädt das XML-Dokument aus dem angegebenen Stream.
Load(TextReader)

Lädt das XML-Dokument aus dem angegebenen TextReader.
Load(String)

Lädt das XML-Dokument aus der angegebenen URL.
Load(XmlReader)

Lädt das XML-Dokument aus dem angegebenen XmlReader.

Load(Stream)

Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs

Lädt das XML-Dokument aus dem angegebenen Stream.

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

inStream
Stream

Der Stream, der das zu ladende XML-Dokument enthält.

Ausnahmen

XmlException

Die XML weist einen Lade- oder Analysefehler auf. In diesem Fall wird eine FileNotFoundException ausgelöst.

Hinweise

Hinweis

Die Load -Methode behält immer einen erheblichen Leerraum bei. Die PreserveWhitespace -Eigenschaft bestimmt, ob unbedeutende Leerzeichen, d. h. Leerzeichen im Elementinhalt, beibehalten werden. Der Standardwert ist false; Leerzeichen im Elementinhalt werden nicht beibehalten.

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

Gilt für:

Load(TextReader)

Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs

Lädt das XML-Dokument aus dem angegebenen TextReader.

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

txtReader
TextReader

Der zum Übertragen von XML-Daten in das Dokument verwendete TextReader.

Ausnahmen

XmlException

Die XML weist einen Lade- oder Analysefehler auf. In diesem Fall bleibt das Dokument leer.

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

Hinweis

Die Load -Methode behält immer einen erheblichen Leerraum bei. Die PreserveWhitespace -Eigenschaft bestimmt, ob unbedeutende Leerzeichen, d. h. Leerzeichen im Elementinhalt, beibehalten werden. Der Standardwert ist false; Leerzeichen im Elementinhalt werden nicht beibehalten.

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

Gilt für:

Load(String)

Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs

Lädt das XML-Dokument aus der angegebenen URL.

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

filename
String

Die URL für die Datei, die das zu ladende XML-Dokument enthält. Die URL kann eine lokale Datei oder eine HTTP-URL (eine Webadresse) sein.

Ausnahmen

XmlException

Die XML weist einen Lade- oder Analysefehler auf. In diesem Fall wird eine FileNotFoundException ausgelöst.

ArgumentException

filename ist eine leere Zeichenfolge, enthält nur Leerzeichen oder enthält mindestens ein ungültiges Zeichen gemäß der Definition von InvalidPathChars.

ArgumentNullException

filename ist null.

PathTooLongException

Der angegebene Pfad und/oder Dateiname überschreiten die vom System definierte maximale Länge.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig (er befindet sich z. B. auf einem nicht zugeordneten Laufwerk).

IOException

Beim Öffnen der Datei ist ein E/A-Fehler aufgetreten.

UnauthorizedAccessException

filename hat eine schreibgeschützte Datei angegeben.

- oder -

Dieser Vorgang wird von der aktuellen Plattform nicht unterstützt.

- oder -

filename hat ein Verzeichnis angegeben.

- oder -

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

FileNotFoundException

Die in filename angegebene Datei wurde nicht gefunden.

NotSupportedException

filename weist ein ungültiges Format auf.

SecurityException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

Hinweise

Hinweis

Die Load -Methode behält immer einen erheblichen Leerraum bei. Die PreserveWhitespace -Eigenschaft bestimmt, ob unbedeutende Leerzeichen, d. h. Leerzeichen im Elementinhalt, beibehalten werden. Der Standardwert ist false; Leerzeichen im Elementinhalt werden nicht beibehalten.

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

Gilt für:

Load(XmlReader)

Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs

Lädt das XML-Dokument aus dem angegebenen XmlReader.

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

reader
XmlReader

Der zum Übertragen von XML-Daten in das Dokument verwendete XmlReader.

Ausnahmen

XmlException

Die XML weist einen Lade- oder Analysefehler auf. In diesem Fall bleibt das Dokument leer.

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

Hinweis

Die Load -Methode behält immer einen erheblichen Leerraum bei. Die PreserveWhitespace -Eigenschaft bestimmt, ob unbedeutende Leerzeichen, d. h. Leerzeichen im Elementinhalt, beibehalten werden. Der Standardwert ist false; Leerzeichen im Elementinhalt werden nicht beibehalten.

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

Gilt für: