XmlDocument.Load Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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).