Freigeben über


XmlDocument.Load Methode

Definition

Lädt die angegebenen XML-Daten aus einer , einer StreamURL, einer TextReaderoder einer XmlReader.

Überlädt

Name Beschreibung
Load(Stream)

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

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
Quelle:
XmlDocument.cs
Quelle:
XmlDocument.cs

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

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

Im XML-Code ist ein Lade- oder Analysefehler vorhanden. In diesem Fall wird eine FileNotFoundException ausgelöst.

Hinweise

Hinweis

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

Wenn die Überprüfung erfolgen soll, können Sie eine Überprüfungsinstanz XmlReader mithilfe der XmlReaderSettings Klasse und der Create Methode erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise auf 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, sollten Sie ein Objekt zum Lesen des Datenstroms verwenden XmlTextReader und dann die XmlTextReader.Encoding Eigenschaft verwenden, um die Codierung zu bestimmen. Wenn Sie ein XmlDocument Objekt zum Arbeiten mit XML verwenden müssen, können Sie das Objekt verwenden, um ein XmlTextReader 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
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

Wird TextReader verwendet, um die XML-Daten in das Dokument zu feeden.

Ausnahmen

Im XML-Code ist ein Lade- oder Analysefehler vorhanden. 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;
using System.IO;
using System.Xml;

public class Sample1
{
  public static void CreateElementExample()
  {
    // Create the XmlDocument.
    XmlDocument doc = new();
    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 signifikanten Leerraum bei. Die PreserveWhitespace Eigenschaft bestimmt, ob unbedeutende Leerzeichen, d. h. Leerzeichen im Elementinhalt, beibehalten werden. Der Standardwert ist false; Leerzeichen im Elementinhalt bleiben nicht erhalten.

Wenn die Überprüfung erfolgen soll, können Sie eine Überprüfungsinstanz XmlReader mithilfe der XmlReaderSettings Klasse und der Create Methode erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise auf 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
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

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

Ausnahmen

Im XML-Code ist ein Lade- oder Analysefehler vorhanden. In diesem Fall wird eine FileNotFoundException ausgelöst.

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

filename ist null.

Der angegebene Pfad, der Dateiname oder beide überschreiten die vom System definierte maximale Länge.

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

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

filename eine Datei angegeben, die schreibgeschützt ist.

- oder -

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

- oder -

filename ein Verzeichnis angegeben.

- oder -

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

Die angegebene filename Datei wurde nicht gefunden.

filename ist in einem ungültigen Format vorhanden.

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

Hinweise

Hinweis

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

Wenn die Überprüfung erfolgen soll, können Sie eine Überprüfungsinstanz XmlReader mithilfe der XmlReaderSettings Klasse und der Create Methode erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise auf 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
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

Wird XmlReader verwendet, um die XML-Daten in das Dokument zu feeden.

Ausnahmen

Im XML-Code ist ein Lade- oder Analysefehler vorhanden. 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;
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 als books.xmlEingabe 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 signifikanten Leerraum bei. Die PreserveWhitespace Eigenschaft bestimmt, ob unbedeutende Leerzeichen, d. h. Leerzeichen im Elementinhalt, beibehalten werden. Der Standardwert ist false; Leerzeichen im Elementinhalt bleiben nicht erhalten.

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

Wenn der Leser 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 die 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ügt. Wenn der aktuelle Knoten und die 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 der Stammebene hinzufügen, andernfalls Save wird eine Ausnahme ausgelöst.

Wenn der Leser auf einem Blattknoten positioniert ist, der für die Stammebene eines Dokuments ungültig ist, z. B. ein Leerzeichen oder Attributknoten, wird der Leser weiterhin gelesen, bis er auf einem Knoten positioniert ist, der für den Stamm verwendet werden kann. Das Dokument beginnt an diesem Punkt zu laden.

Wenn die Überprüfung erfolgen soll, können Sie eine Überprüfungsinstanz XmlReader mithilfe der XmlReaderSettings Klasse und der Create Methode erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.

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

Weitere Informationen

Gilt für: