XmlDataDocument.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 XmlDataDocument Verwendung der angegebenen Datenquelle und synchronisiert die DataSet geladenen Daten.
Überlädt
| Name | Beschreibung |
|---|---|
| Load(Stream) |
Lädt den |
| Load(TextReader) |
Lädt die aus |
| Load(String) |
Lädt die |
| Load(XmlReader) |
Lädt die aus |
Hinweise
Hinweis
Um die XML-Daten relational anzeigen zu können, müssen Sie zuerst ein Schema angeben, das für die Datenzuordnung verwendet werden soll. Dies kann entweder durch Aufrufen der ReadXmlSchema Methode oder durch manuelles Erstellen der Tabellen und Spalten erfolgen DataSet . Dieser Schritt muss vor dem Aufrufen Loaderfolgen.
XmlDataDocument unterstützt das Erstellen von Entitätsverweisen nicht. Wenn die Daten Entitätsverweise enthalten, löst die Load Methode alle Entitätsverweise auf und erweitert sie. Wenn Sie jedoch die Überladung verwenden, die Load ein Argument akzeptiert XmlReader , müssen Sie ein XmlReader Argument angeben, mit dem Entitäten aufgelöst werden können.
Load(Stream)
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
Lädt den XmlDataDocument aus dem angegebenen Datenstrom.
public:
override void Load(System::IO::Stream ^ inStream);public override void Load(System.IO.Stream inStream);override this.Load : System.IO.Stream -> unitPublic Overrides Sub Load (inStream As Stream)Parameter
- inStream
- Stream
Der Stream, der das zu ladende XML-Dokument enthält.
Hinweise
XmlDataDocument unterstützt das Erstellen von Entitätsverweisen nicht. Wenn die Daten Entitätsverweise enthalten, löst die Load Methode alle Entitätsverweise auf und erweitert sie.
Hinweis
Um die XML-Daten relational anzeigen zu können, müssen Sie zuerst ein Schema angeben, das für die Datenzuordnung verwendet werden soll. Dies kann entweder durch Aufrufen der ReadXmlSchema Methode oder durch manuelles Erstellen der Tabellen und Spalten erfolgen DataSet . Dieser Schritt muss vor dem Aufrufen Loaderfolgen.
Gilt für:
Load(TextReader)
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
Lädt die aus XmlDataDocument der angegebenen TextReader.
public:
override void Load(System::IO::TextReader ^ txtReader);public override void Load(System.IO.TextReader txtReader);override this.Load : System.IO.TextReader -> unitPublic Overrides Sub Load (txtReader As TextReader)Parameter
- txtReader
- TextReader
Wird TextReader verwendet, um die XML-Daten in das Dokument zu feeden.
Hinweise
XmlDataDocument unterstützt das Erstellen von Entitätsverweisen nicht. Wenn die Daten Entitätsverweise enthalten, löst die Load Methode alle Entitätsverweise auf und erweitert sie.
Hinweis
Um die XML-Daten relational anzeigen zu können, müssen Sie zuerst ein Schema angeben, das für die Datenzuordnung verwendet werden soll. Dies kann entweder durch Aufrufen der ReadXmlSchema Methode oder durch manuelles Erstellen der Tabellen und Spalten erfolgen DataSet . Dieser Schritt muss vor dem Aufrufen Loaderfolgen.
Gilt für:
Load(String)
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
Lädt die XmlDataDocument angegebene URL.
public:
override void Load(System::String ^ filename);public override void Load(string filename);override this.Load : string -> unitPublic Overrides Sub Load (filename As String)Parameter
- filename
- String
Die URL der Datei, die das zu ladende XML-Dokument enthält.
Hinweise
XmlDataDocument unterstützt das Erstellen von Entitätsverweisen nicht. Wenn die Daten Entitätsverweise enthalten, löst die Load Methode alle Entitätsverweise auf und erweitert sie.
Hinweis
Um die XML-Daten relational anzeigen zu können, müssen Sie zuerst ein Schema angeben, das für die Datenzuordnung verwendet werden soll. Dies kann entweder durch Aufrufen der ReadXmlSchema Methode oder durch manuelles Erstellen der Tabellen und Spalten erfolgen DataSet . Dieser Schritt muss vor dem Aufrufen Loaderfolgen.
Gilt für:
Load(XmlReader)
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
- Quelle:
- XmlDataDocument.cs
Lädt die aus XmlDataDocument der angegebenen XmlReader.
public:
override void Load(System::Xml::XmlReader ^ reader);public override void Load(System.Xml.XmlReader reader);override this.Load : System.Xml.XmlReader -> unitPublic Overrides Sub Load (reader As XmlReader)Parameter
- reader
- XmlReader
Das XmlReader zu ladende XML-Dokument.
Ausnahmen
Der geladene XML-Code enthält Entitätsverweise, und der Leser kann Entitäten nicht auflösen.
Hinweise
XmlDataDocument unterstützt das Erstellen von Entitätsverweisen nicht. Wenn die Datenquelle Entitätsverweise enthält, müssen Sie eine XmlValidatingReader mit der EntityHandling Eigenschaft "EntityHandling.ExpandEntities" (dies ist das Standardverhalten) erstellen und die XmlValidatingReaderLoad Methode übergeben. Wenn Sie keine Methode verwenden XmlValidatingReader, löst die Load Methode eine Ausnahme aus.
Die Load Methode behält immer einen signifikanten Leerraum bei. Die PreserveWhitespace Eigenschaft bestimmt, ob Leerzeichen beibehalten werden. Der Standardwert ist false, Leerzeichen werden nicht beibehalten.
Wenn sich der Leser im Anfangszustand befindet (d. h. 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 tiefe "n" schließt. Dies hat die folgenden Ergebnisse.
Wenn der aktuelle Knoten und die folgenden gleichgeordneten Elemente ähnlich 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 die folgenden gleichgeordneten Elemente ähnlich wie folgt aussehen:
<!--comment--><?process
instruction?><!--comment--></endtag>
Load wird erfolgreich sein; Sie verfügen jedoch über eine unvollständige DOM-Struktur, da kein Element auf Stammebene vorhanden ist. Sie müssen ein Element auf Stammebene hinzufügen, bevor Sie das Dokument speichern. andernfalls löst die Save Methode eine Ausnahme aus.
Wenn der Leser auf einem Blattknoten positioniert ist, der für die Stammebene eines Dokuments ungültig ist (z. B. ein Leerzeichen oder Attributknoten), liest der Leser weiter, bis er auf einem Knoten positioniert ist, der für den Stamm verwendet werden kann. Das Dokument beginnt an diesem Punkt zu laden.
