XDocument Klasse

Referenz

Definition

Namespace:: System.Xml.Linq

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: netstandard.dll

Quelle:: XDocument.cs

Quelle:: XDocument.cs

Quelle:: XDocument.cs

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. Informationen zu den Komponenten und zur Verwendung eines XDocument-Objekts finden Sie unter Übersicht über die „XDocument“-Klasse.

public ref class XDocument : System::Xml::Linq::XContainer

public class XDocument : System.Xml.Linq.XContainer

type XDocument = class
    inherit XContainer

Public Class XDocument
Inherits XContainer

Vererbung: Object

XObject

XNode

XContainer
XDocument

Beispiele

Im folgenden Beispiel wird ein Dokument erstellt und anschließend ein Kommentar und ein Element hinzugefügt. Anschließend wird ein weiteres Dokument mit den Ergebnissen 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 XDocumentfinden Sie unter Gültiger Inhalt von XElement- und XDocument-Objekten.

Konstruktoren

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 der angegebenen XDeclaration und dem angegebenen Inhalt.
XDocument(XDocument)	Initialisiert eine neue Instanz der XDocument-Klasse mit einem vorhandenen XDocument-Objekt.

Eigenschaften

BaseUri	Ruft den Basis-URI für dieses XObject ab. (Geerbt von XObject)
Declaration	Ruft die XML-Deklaration für das Dokument ab oder legt diese fest.
Document	Ruft den XDocument für diesen XObject ab. (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 nebengeordneten Knoten dieses Knotens ab. (Geerbt von XNode)
NodeType	Ruft den Knotentyp für diesen Knoten ab.
Parent	Ruft das übergeordnete XElement dieses XObject ab. (Geerbt von XObject)
PreviousNode	Ruft den vorherigen nebengeordneten Knoten dieses Knotens ab. (Geerbt von XNode)
Root	Ruft das Stammelement der XML-Struktur für dieses Dokument ab.

Methoden

Add(Object)	Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu. (Geerbt von XContainer)
Add(Object[])	Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu. (Geerbt von XContainer)
AddAfterSelf(Object)	Fügt den angegebenen Inhalt unmittelbar hinter diesem Knoten hinzu. (Geerbt von XNode)
AddAfterSelf(Object[])	Fügt den angegebenen Inhalt unmittelbar hinter diesem Knoten hinzu. (Geerbt von XNode)
AddAnnotation(Object)	Fügt der Anmerkungsliste dieses XObject ein Objekt hinzu. (Geerbt von XObject)
AddBeforeSelf(Object)	Fügt den angegebenen Inhalt direkt vor diesem Knoten hinzu. (Geerbt von XNode)
AddBeforeSelf(Object[])	Fügt den angegebenen Inhalt direkt vor diesem Knoten hinzu. (Geerbt von XNode)
AddFirst(Object)	Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu. (Geerbt von XContainer)
AddFirst(Object[])	Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu. (Geerbt von XContainer)
Ancestors()	Gibt eine Auflistung der übergeordneten Elemente dieses Knotens zurück. (Geerbt von XNode)
Ancestors(XName)	Gibt eine gefilterte Auflistung der übergeordneten Elemente dieses Knotens zurück. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten. (Geerbt von XNode)
Annotation(Type)	Ruft das erste Anmerkungsobjekt des angegebenen Typs aus diesem XObject ab. (Geerbt von XObject)
Annotation<T>()	Ruft das erste Anmerkungsobjekt des angegebenen Typs aus diesem XObject ab. (Geerbt von XObject)
Annotations(Type)	Ruft eine Auflistung von Anmerkungen des angegebenen Typs für dieses XObject ab. (Geerbt von XObject)
Annotations<T>()	Ruft eine Auflistung von Anmerkungen des angegebenen Typs für dieses XObject ab. (Geerbt von XObject)
CreateReader()	Erstellt einen XmlReader für diesen Knoten. (Geerbt von XNode)
CreateReader(ReaderOptions)	Erstellt einen XmlReader mit den im `readerOptions`-Parameter angegebenen Optionen. (Geerbt von XNode)
CreateWriter()	Erstellt einen XmlWriter, der zum Hinzufügen von Knoten zu dem XContainer verwendet werden kann. (Geerbt von XContainer)
DescendantNodes()	Gibt eine Auflistung der Nachfolgerknoten für dieses Dokument oder Element in Dokumentreihenfolge zurück. (Geerbt von XContainer)
Descendants()	Gibt eine Auflistung der Nachfolgerelemente für dieses Dokument oder Element in Dokumentreihenfolge zurück. (Geerbt von XContainer)
Descendants(XName)	Gibt eine gefilterte Auflistung der Nachfolgerelemente für dieses Dokument oder Element in Dokumentreihenfolge zurück. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten. (Geerbt von XContainer)
Element(XName)	Ruft das erste (in Dokumentreihenfolge) untergeordnete Element mit dem angegebenen XName ab. (Geerbt von XContainer)
Elements()	Gibt eine Auflistung der untergeordneten Elemente dieses Dokuments oder Elements in Dokumentreihenfolge zurück. (Geerbt von XContainer)
Elements(XName)	Gibt eine gefilterte Auflistung der untergeordneten Elemente dieses Dokuments oder Elements in Dokumentreihenfolge zurück. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten. (Geerbt von XContainer)
ElementsAfterSelf()	Gibt eine Auflistung der nebengeordneten Elemente nach diesem Knoten in Dokumentreihenfolge zurück. (Geerbt von XNode)
ElementsAfterSelf(XName)	Gibt eine gefilterte Auflistung der nebengeordneten Elemente nach diesem Knoten in Dokumentreihenfolge zurück. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten. (Geerbt von XNode)
ElementsBeforeSelf()	Gibt eine Auflistung der nebengeordneten Elemente vor diesem Knoten in Dokumentreihenfolge zurück. (Geerbt von XNode)
ElementsBeforeSelf(XName)	Gibt eine gefilterte Auflistung der nebengeordneten Elemente vor diesem Knoten in Dokumentreihenfolge zurück. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten. (Geerbt von XNode)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsAfter(XNode)	Bestimmt, ob der aktuelle Knoten nach einem angegebenen Knoten in der Dokumentreihenfolge angezeigt wird. (Geerbt von XNode)
IsBefore(XNode)	Bestimmt, ob der aktuelle Knoten vor einem angegebenen Knoten in der Dokumentreihenfolge angezeigt wird. (Geerbt von XNode)
Load(Stream)	Erstellt mit dem angegebenen Stream eine neue XDocument-Instanz.
Load(Stream, LoadOptions)	Erstellt mithilfe des angegebenen Streams eine neue XDocument-Instanz, wobei optional Leerraum und Zeileninformationen beibehalten werden und der Basis-URI festgelegt wird.
Load(String)	Erstellt ein neues XDocument aus einer Datei.
Load(String, LoadOptions)	Erstellt ein neues XDocument aus einer Datei, wobei optional Leerraum und Zeileninformationen beibehalten werden und der Basis-URI festgelegt wird.
Load(TextReader)	Erstellt ein neues XDocument aus einem TextReader.
Load(TextReader, LoadOptions)	Erstellt ein neues XDocument aus einem TextReader, wobei optional Leerraum und Zeileninformationen beibehalten werden und der Basis-URI festgelegt wird.
Load(XmlReader)	Erstellt ein neues XDocument aus einem XmlReader.
Load(XmlReader, LoadOptions)	Lädt ein XDocument aus einem XmlReader, wobei optional der Basis-URI festgelegt wird und die Zeileninformationen beibehalten werden.
LoadAsync(Stream, LoadOptions, CancellationToken)	Erstellt asynchron ein neues XDocument und initialisiert die zugrunde liegende XML-Struktur unter Verwendung des angegebenen Datenstroms, wobei optional Leerraum beibehalten wird.
LoadAsync(TextReader, LoadOptions, CancellationToken)	Erstellt ein neues XDocument und initialisiert die zugrunde liegende XML-Struktur unter Verwendung des angegebenen TextReader-Parameters, wobei optional Leerraum beibehalten wird.
LoadAsync(XmlReader, LoadOptions, CancellationToken)	Erstellt ein neues XDocument, das den Inhalt des angegebenen XmlReader enthält.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Nodes()	Gibt eine Auflistung der untergeordneten Knoten dieses Dokuments oder Elements in Dokumentreihenfolge zurück. (Geerbt von XContainer)
NodesAfterSelf()	Gibt eine Auflistung der nebengeordneten Knoten nach diesem Knoten in Dokumentreihenfolge zurück. (Geerbt von XNode)
NodesBeforeSelf()	Gibt eine Auflistung der nebengeordneten Knoten vor diesem Knoten in Dokumentreihenfolge zurück. (Geerbt von XNode)
Parse(String)	Erstellt ein neues XDocument aus einer Zeichenfolge.
Parse(String, LoadOptions)	Erstellt ein neues XDocument aus einer Zeichenfolge, wobei optional Leerraum und Zeileninformationen beibehalten werden und der Basis-URI festgelegt wird.
Remove()	Entfernt diesen Knoten aus seinem übergeordneten Element. (Geerbt von XNode)
RemoveAnnotations(Type)	Entfernt die Anmerkungen vom angegebenen Typ aus diesem XObject. (Geerbt von XObject)
RemoveAnnotations<T>()	Entfernt die Anmerkungen vom angegebenen Typ 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)	Gibt diesen XDocument an den angegebenen Stream aus.
Save(Stream, SaveOptions)	Gibt dieses XDocument zum angegebenen Stream aus und gibt Formatierungsverhalten optional an.
Save(String)	Serialisieren Sie dieses XDocument in eine Datei, und überschreiben Sie dabei eine vorhandene Datei, sofern vorhanden.
Save(String, SaveOptions)	Serialisiert dieses XDocument in eine Datei, wobei optional die Formatierung deaktiviert wird.
Save(TextWriter)	Serialisiert dieses XDocument in einen TextWriter.
Save(TextWriter, SaveOptions)	Serialisiert dieses XDocument in einen TextWriter, wobei optional die Formatierung deaktiviert wird.
Save(XmlWriter)	Serialisiert dieses XDocument in einen XmlWriter.
SaveAsync(Stream, SaveOptions, CancellationToken)	Geben Sie dieses XDocument in einen Stream aus.
SaveAsync(TextWriter, SaveOptions, CancellationToken)	Schreibt dieses XDocument in einen TextWriter.
SaveAsync(XmlWriter, CancellationToken)	Schreibt dieses XDocument in einen XmlWriter.
ToString()	Gibt das eingezogene XML für diesen Knoten zurück. (Geerbt von XNode)
ToString(SaveOptions)	Gibt das XML für diesen Knoten zurück, wobei optional die Formatierung deaktiviert wird. (Geerbt von XNode)
WriteTo(XmlWriter)	Schreibt dieses Dokument in einen XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Schreibt die zugrunde liegende XML-Struktur dieser XDocument-Instanz in den angegebenen XmlWriter.
WriteToAsync(XmlWriter, CancellationToken)	Schreibt den aktuellen Knoten in eine XmlWriter-Klasse. (Geerbt von XNode)

Ereignisse

Changed	Wird ausgelöst, wenn dieses XObject oder eines seiner untergeordneten Elemente geändert wurde. (Geerbt von XObject)
Changing	Wird ausgelöst, wenn dieses XObject oder eines seiner untergeordneten Elemente gerade geändert wird. (Geerbt von XObject)

Explizite Schnittstellenimplementierungen

IXmlLineInfo.HasLineInfo()	Ruft einen Wert ab, der angibt, ob dieses XObject Zeileninformationen aufweist. (Geerbt von XObject)
IXmlLineInfo.LineNumber	Ruft die Zeilennummer ab, die der zugrunde liegende XmlReader für dieses XObject angegeben hat. (Geerbt von XObject)
IXmlLineInfo.LinePosition	Ruft die Zeilenposition ab, die der zugrunde liegende XmlReader für dieses XObject angegeben hat. (Geerbt von XObject)

Erweiterungsmethoden

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)	Diese Methode validiert, ob ein XDocument einer XSD in einem XmlSchemaSet entspricht.
Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)	Validiert, ob ein XDocument einer XSD in einem XmlSchemaSet entspricht, und füllt die XML-Struktur optional mit dem Post-Schema-Validation-Infoset (PSVI) auf.
CreateNavigator(XNode)	Erstellt einen XPathNavigator für einen XNode.
CreateNavigator(XNode, XmlNameTable)	Erstellt einen XPathNavigator für einen XNode. Die XmlNameTable ermöglicht eine effizientere Verarbeitung von XPath-Ausdrücken.
XPathEvaluate(XNode, String)	Wertet einen XPath-Ausdruck aus.
XPathEvaluate(XNode, String, IXmlNamespaceResolver)	Wertet einen XPath-Ausdruck aus und löst Namespacepräfixe mit dem angegebenen IXmlNamespaceResolver auf.
XPathSelectElement(XNode, String)	Wählt mithilfe eines XPath-Ausdrucks ein XElement aus.
XPathSelectElement(XNode, String, IXmlNamespaceResolver)	Wählt mithilfe eines XPath-Ausdrucks ein XElement aus und löst Namespacepräfixe mit dem angegebenen IXmlNamespaceResolver auf.
XPathSelectElements(XNode, String)	Wählt mithilfe eines XPath-Ausdrucks eine Auflistung von Elementen aus.
XPathSelectElements(XNode, String, IXmlNamespaceResolver)	Wählt mithilfe eines XPath-Ausdrucks eine Auflistung von Elementen aus und löst Namespacepräfixe mit dem angegebenen IXmlNamespaceResolver auf.
ToXPathNavigable(XNode)	Gibt einen Accessor zurück, mit dem Sie das angegebene XNode-Objekt navigieren und bearbeiten können.

Gilt für:

Freigeben über