XDocument Klasse
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.
Stellt ein XML-Dokument dar. Die Komponenten und die Verwendung eines XDocument Objekts finden Sie unter "XDocument Class Overview".
public ref class XDocument : System::Xml::Linq::XContainerpublic class XDocument : System.Xml.Linq.XContainertype XDocument = class
inherit XContainerPublic Class XDocument
Inherits XContainer- Vererbung
Beispiele
Im folgenden Beispiel wird ein Dokument erstellt und anschließend ein Kommentar und ein Element hinzugefügt. Anschließend wird ein weiteres Dokument mithilfe der Ergebnisse einer Abfrage erstellt.
XDocument srcTree = new XDocument(
new XComment("This is a comment"),
new XElement("Root",
new XElement("Child1", "data1"),
new XElement("Child2", "data2"),
new XElement("Child3", "data3"),
new XElement("Child2", "data4"),
new XElement("Info5", "info5"),
new XElement("Info6", "info6"),
new XElement("Info7", "info7"),
new XElement("Info8", "info8")
)
);
XDocument doc = new XDocument(
new XComment("This is a comment"),
new XElement("Root",
from el in srcTree.Element("Root").Elements()
where ((string)el).StartsWith("data")
select el
)
);
Console.WriteLine(doc);
Dim srcTree As XDocument = _
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<!--This is a comment-->
<Root>
<Child1>data1</Child1>
<Child2>data2</Child2>
<Child3>data3</Child3>
<Child2>data4</Child2>
<Info5>info5</Info5>
<Info6>info6</Info6>
<Info7>info7</Info7>
<Info8>info8</Info8>
</Root>
Dim doc As XDocument = _
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<!--This is a comment-->
<Root>
<%= From el In srcTree.<Root>.Elements _
Where CStr(el).StartsWith("data") _
Select el %>
</Root>
Console.WriteLine(doc)
Dieses Beispiel erzeugt die folgende Ausgabe:
<!--This is a comment-->
<Root>
<Child1>data1</Child1>
<Child2>data2</Child2>
<Child3>data3</Child3>
<Child2>data4</Child2>
</Root>
Hinweise
Ausführliche Informationen zum gültigen Inhalt eines XDocumentElements finden Sie unter "Valid Content of XElement" und "XDocument Objects".
Konstruktoren
| Name | Beschreibung |
|---|---|
| XDocument() |
Initialisiert eine neue Instanz der XDocument-Klasse. |
| XDocument(Object[]) |
Initialisiert eine neue Instanz der XDocument Klasse mit dem angegebenen Inhalt. |
| XDocument(XDeclaration, Object[]) |
Initialisiert eine neue Instanz der XDocument Klasse mit dem angegebenen XDeclaration Und Inhalt. |
| XDocument(XDocument) |
Initialisiert eine neue Instanz der XDocument Klasse aus einem vorhandenen XDocument Objekt. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| BaseUri |
Ruft den Basis-URI für diese XObjectab. (Geerbt von XObject) |
| Declaration |
Dient zum Abrufen oder Festlegen der XML-Deklaration für dieses Dokument. |
| Document | (Geerbt von XObject) |
| DocumentType |
Ruft die Dokumenttypdefinition (DTD) für dieses Dokument ab. |
| FirstNode |
Ruft den ersten untergeordneten Knoten dieses Knotens ab. (Geerbt von XContainer) |
| LastNode |
Ruft den letzten untergeordneten Knoten dieses Knotens ab. (Geerbt von XContainer) |
| NextNode |
Ruft den nächsten gleichgeordneten Knoten dieses Knotens ab. (Geerbt von XNode) |
| NodeType |
Ruft den Knotentyp für diesen Knoten ab. |
| Parent |
Ruft das übergeordnete XElement Element dieser XObject. (Geerbt von XObject) |
| PreviousNode |
Ruft den vorherigen gleichgeordneten Knoten dieses Knotens ab. (Geerbt von XNode) |
| Root |
Ruft das Stammelement der XML-Struktur für dieses Dokument ab. |
Methoden
| Name | Beschreibung |
|---|---|
| Add(Object) |
Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainerInhalts hinzu. (Geerbt von XContainer) |
| Add(Object[]) |
Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainerInhalts hinzu. (Geerbt von XContainer) |
| AddAfterSelf(Object) |
Fügt den angegebenen Inhalt unmittelbar nach diesem Knoten hinzu. (Geerbt von XNode) |
| AddAfterSelf(Object[]) |
Fügt den angegebenen Inhalt unmittelbar nach diesem Knoten hinzu. (Geerbt von XNode) |
| AddAnnotation(Object) |
Fügt der Anmerkungsliste dieses XObjectObjekts ein Objekt hinzu. (Geerbt von XObject) |
| AddBeforeSelf(Object) |
Fügt den angegebenen Inhalt unmittelbar vor diesem Knoten hinzu. (Geerbt von XNode) |
| AddBeforeSelf(Object[]) |
Fügt den angegebenen Inhalt unmittelbar vor diesem Knoten hinzu. (Geerbt von XNode) |
| AddFirst(Object) |
Fügt den angegebenen Inhalt als die ersten untergeordneten Elemente dieses Dokuments oder Elements hinzu. (Geerbt von XContainer) |
| AddFirst(Object[]) |
Fügt den angegebenen Inhalt als die ersten untergeordneten Elemente dieses Dokuments oder Elements hinzu. (Geerbt von XContainer) |
| Ancestors() |
Gibt eine Auflistung der Vorgängerelemente dieses Knotens zurück. (Geerbt von XNode) |
| Ancestors(XName) |
Gibt eine gefilterte Auflistung der Vorgängerelemente dieses Knotens zurück. In der Auflistung sind nur Elemente enthalten, die über einen übereinstimmenden XName verfügen. (Geerbt von XNode) |
| Annotation(Type) |
Ruft das erste Anmerkungsobjekt des angegebenen Typs von diesem XObjectab. (Geerbt von XObject) |
| Annotation<T>() |
Ruft das erste Anmerkungsobjekt des angegebenen Typs von diesem XObjectab. (Geerbt von XObject) |
| Annotations(Type) |
Ruft eine Auflistung von Anmerkungen des angegebenen Typs für diese XObjectab. (Geerbt von XObject) |
| Annotations<T>() |
Ruft eine Auflistung von Anmerkungen des angegebenen Typs für diese XObjectab. (Geerbt von XObject) |
| CreateReader() |
Erstellt einen XmlReader für diesen Knoten. (Geerbt von XNode) |
| CreateReader(ReaderOptions) |
Erstellt eine XmlReader mit den durch den |
| CreateWriter() |
Erstellt eine XmlWriter , die zum Hinzufügen von Knoten zum Hinzufügen von XContainerKnoten verwendet werden kann. (Geerbt von XContainer) |
| DescendantNodes() |
Gibt eine Auflistung der untergeordneten Knoten für dieses Dokument oder Element in der Dokumentreihenfolge zurück. (Geerbt von XContainer) |
| Descendants() |
Gibt eine Auflistung der untergeordneten Elemente für dieses Dokument oder Element in der Dokumentreihenfolge zurück. (Geerbt von XContainer) |
| Descendants(XName) |
Gibt eine gefilterte Auflistung der untergeordneten Elemente für dieses Dokument oder Element in der Dokumentreihenfolge zurück. In der Auflistung sind nur Elemente enthalten, die über einen übereinstimmenden XName verfügen. (Geerbt von XContainer) |
| Element(XName) |
Ruft das erste untergeordnete Element (in Dokumentreihenfolge) mit dem angegebenen ab XName. (Geerbt von XContainer) |
| Elements() |
Gibt eine Auflistung der untergeordneten Elemente dieses Elements oder Dokuments in der Dokumentreihenfolge zurück. (Geerbt von XContainer) |
| Elements(XName) |
Gibt eine gefilterte Auflistung der untergeordneten Elemente dieses Elements oder Dokuments in der Dokumentreihenfolge zurück. In der Auflistung sind nur Elemente enthalten, die über einen übereinstimmenden XName verfügen. (Geerbt von XContainer) |
| ElementsAfterSelf() |
Gibt eine Auflistung der gleichgeordneten Elemente nach diesem Knoten in der Dokumentreihenfolge zurück. (Geerbt von XNode) |
| ElementsAfterSelf(XName) |
Gibt eine gefilterte Auflistung der gleichgeordneten Elemente nach diesem Knoten in Dokumentreihenfolge zurück. In der Auflistung sind nur Elemente enthalten, die über einen übereinstimmenden XName verfügen. (Geerbt von XNode) |
| ElementsBeforeSelf() |
Gibt eine Auflistung der gleichgeordneten Elemente vor diesem Knoten in der Dokumentreihenfolge zurück. (Geerbt von XNode) |
| ElementsBeforeSelf(XName) |
Gibt eine gefilterte Auflistung der gleichgeordneten Elemente vor diesem Knoten in der Dokumentreihenfolge zurück. In der Auflistung sind nur Elemente enthalten, die über einen übereinstimmenden XName verfügen. (Geerbt von XNode) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| IsAfter(XNode) |
Bestimmt, ob der aktuelle Knoten nach einem angegebenen Knoten in Bezug auf die Dokumentreihenfolge angezeigt wird. (Geerbt von XNode) |
| IsBefore(XNode) |
Bestimmt, ob der aktuelle Knoten vor einem angegebenen Knoten in Bezug auf die Dokumentreihenfolge angezeigt wird. (Geerbt von XNode) |
| Load(Stream, LoadOptions) |
Erstellt eine neue XDocument Instanz mithilfe des angegebenen Datenstroms, optional unter Beibehaltung von Leerzeichen, Festlegen des Basis-URI und Aufbewahren von Zeileninformationen. |
| Load(Stream) |
Erstellt eine neue XDocument Instanz mithilfe des angegebenen Datenstroms. |
| Load(String, LoadOptions) |
Erstellt eine neue XDocument Datei, optional wird Leerraum beibehalten, basis-URI festgelegt und Zeileninformationen beibehalten. |
| Load(String) |
Erstellt eine neue XDocument aus einer Datei. |
| Load(TextReader, LoadOptions) |
Erstellt ein neues Aus XDocument einem TextReader, optional beibehalten Leerzeichen, Festlegen des Basis-URI und Aufbewahren von Zeileninformationen. |
| Load(TextReader) |
Erstellt ein neues XDocument aus einem TextReader. |
| Load(XmlReader, LoadOptions) |
Lädt einen XDocument Wert aus einem XmlReader, optional festlegen den Basis-URI und das Aufbewahren von Zeileninformationen. |
| Load(XmlReader) | |
| LoadAsync(Stream, LoadOptions, CancellationToken) |
Erstellt asynchron eine neue XDocument und initialisiert die zugrunde liegende XML-Struktur aus dem angegebenen Datenstrom, optional wird Leerraum beibehalten. |
| LoadAsync(TextReader, LoadOptions, CancellationToken) |
Erstellt eine neue XDocument und initialisiert die zugrunde liegende XML-Struktur mithilfe des angegebenen TextReader Parameters, optional wird Leerraum beibehalten. |
| LoadAsync(XmlReader, LoadOptions, CancellationToken) |
Erstellt eine neue XDocument , die den Inhalt der angegebenen XmlReader. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| Nodes() |
Gibt eine Auflistung der untergeordneten Knoten dieses Elements oder Dokuments in der Dokumentreihenfolge zurück. (Geerbt von XContainer) |
| NodesAfterSelf() |
Gibt eine Auflistung der gleichgeordneten Knoten nach diesem Knoten in Dokumentreihenfolge zurück. (Geerbt von XNode) |
| NodesBeforeSelf() |
Gibt eine Auflistung der gleichgeordneten Knoten vor diesem Knoten in der Dokumentreihenfolge zurück. (Geerbt von XNode) |
| Parse(String, LoadOptions) |
Erstellt eine neue XDocument Aus einer Zeichenfolge, optional beibehalten Leerzeichen, Festlegen des Basis-URI und Aufbewahren von Zeileninformationen. |
| Parse(String) |
Erstellt eine neue XDocument aus einer Zeichenfolge. |
| Remove() |
Entfernt diesen Knoten aus dem übergeordneten Element. (Geerbt von XNode) |
| RemoveAnnotations(Type) |
Entfernt die Anmerkungen des angegebenen Typs aus diesem XObject. (Geerbt von XObject) |
| RemoveAnnotations<T>() |
Entfernt die Anmerkungen des angegebenen Typs aus diesem XObject. (Geerbt von XObject) |
| RemoveNodes() |
Entfernt die untergeordneten Knoten aus diesem Dokument oder Element. (Geerbt von XContainer) |
| ReplaceNodes(Object) |
Ersetzt die untergeordneten Knoten dieses Dokuments oder Elements durch den angegebenen Inhalt. (Geerbt von XContainer) |
| ReplaceNodes(Object[]) |
Ersetzt die untergeordneten Knoten dieses Dokuments oder Elements durch den angegebenen Inhalt. (Geerbt von XContainer) |
| ReplaceWith(Object) |
Ersetzt diesen Knoten durch den angegebenen Inhalt. (Geerbt von XNode) |
| ReplaceWith(Object[]) |
Ersetzt diesen Knoten durch den angegebenen Inhalt. (Geerbt von XNode) |
| Save(Stream, SaveOptions) |
Gibt dies XDocument an den angegebenen Stream, optional das Formatierungsverhalten an. |
| Save(Stream) | |
| Save(String, SaveOptions) |
Serialisieren Sie dies XDocument in eine Datei, und deaktivieren Sie optional die Formatierung. |
| Save(String) |
Serialisieren Sie dies XDocument in eine Datei, und überschreiben Sie ggf. eine vorhandene Datei. |
| Save(TextWriter, SaveOptions) |
Serialisieren Sie dies XDocument auf eine TextWriter, optional deaktivierung der Formatierung. |
| Save(TextWriter) |
Serialisieren Sie dies XDocument in ein TextWriter. |
| Save(XmlWriter) | |
| SaveAsync(Stream, SaveOptions, CancellationToken) | |
| SaveAsync(TextWriter, SaveOptions, CancellationToken) |
Schreibt dies XDocument in ein TextWriter. |
| SaveAsync(XmlWriter, CancellationToken) | |
| ToString() |
Gibt den eingerückten XML-Code für diesen Knoten zurück. (Geerbt von XNode) |
| ToString(SaveOptions) |
Gibt den XML-Code für diesen Knoten zurück, optional wird die Formatierung deaktiviert. (Geerbt von XNode) |
| WriteTo(XmlWriter) |
Schreiben Sie dieses Dokument in ein XmlWriter. |
| WriteToAsync(XmlWriter, CancellationToken) |
Schreibt die zugrunde liegende XML-Struktur dieses XDocument in die angegebene XmlWriter. |
Ereignisse
| Name | Beschreibung |
|---|---|
| Changed |
Wird ausgelöst, wenn sich dies XObject oder eines seiner Nachfolger geändert hat. (Geerbt von XObject) |
| Changing |
Wird ausgelöst, wenn sich dies XObject oder eines seiner Nachfolger ändert. (Geerbt von XObject) |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| IXmlLineInfo.HasLineInfo() |
Ruft einen Wert ab, der angibt, ob dies XObject Zeileninformationen enthält. (Geerbt von XObject) |
| IXmlLineInfo.LineNumber |
Ruft die Zeilennummer ab, die der zugrunde liegende XmlReader für dieses XObjectAngegeben hat. (Geerbt von XObject) |
| IXmlLineInfo.LinePosition |
Ruft die Zeilenposition ab, die der zugrunde liegende XmlReader für diesen XObjectBericht gemeldet hat. (Geerbt von XObject) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| CreateNavigator(XNode, XmlNameTable) |
Erstellt eine XPathNavigator für ein XNode. Dies XmlNameTable ermöglicht eine effizientere XPath-Ausdrucksverarbeitung. |
| CreateNavigator(XNode) |
Erstellt eine XPathNavigator für ein XNode. |
| ToXPathNavigable(XNode) |
Gibt einen Accessor zurück, mit dem Sie navigieren und die angegebene XNodeEigenschaft bearbeiten können. |
| Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean) |
Überprüft, ob ein XDocument XSD-Wert in einer XmlSchemaSetXML-Struktur entspricht, die optional die XML-Struktur mit dem Post-Schema-Validation-Infoset (PSVI) auffüllt. |
| Validate(XDocument, XmlSchemaSet, ValidationEventHandler) |
Diese Methode überprüft, ob eine XDocument XSD in einer XmlSchemaSet. |
| XPathEvaluate(XNode, String, IXmlNamespaceResolver) |
Wertet einen XPath-Ausdruck aus, wobei Namespacepräfixe mithilfe des angegebenen Präfixes aufgelöst werden IXmlNamespaceResolver. |
| XPathEvaluate(XNode, String) |
Wertet einen XPath-Ausdruck aus. |
| XPathSelectElement(XNode, String, IXmlNamespaceResolver) |
Wählt einen XElement XPath-Ausdruck aus, wobei Namespacepräfixe mithilfe des angegebenen Präfixes aufgelöst werden IXmlNamespaceResolver. |
| XPathSelectElement(XNode, String) |
Wählt einen XElement XPath-Ausdruck aus. |
| XPathSelectElements(XNode, String, IXmlNamespaceResolver) |
Wählt eine Auflistung von Elementen mithilfe eines XPath-Ausdrucks aus, wobei Namespacepräfixe mithilfe des angegebenen Präfixes aufgelöst werden IXmlNamespaceResolver. |
| XPathSelectElements(XNode, String) |
Wählt eine Auflistung von Elementen mithilfe eines XPath-Ausdrucks aus. |
