XDocument Klasse

Definition

Stellt ein XML-Dokument dar.Represents an XML document. Informationen zu den Komponenten und zur Verwendung eines XDocument-Objekts finden Sie unter Übersicht über die „XDocument“-Klasse.For the components and usage of an XDocument object, see XDocument Class Overview.

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

Beispiele

Im folgenden Beispiel wird ein Dokument erstellt und dann ein Kommentar und ein Element hinzugefügt.The following example creates a document, and then adds a comment and an element to it. Anschließend wird ein anderes Dokument mit den Ergebnissen einer Abfrage verfasst.It then composes another document using the results of a query.

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 example produces the following output:

<!--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 XDocumenteines-Objekts finden Sie unter gültiger Inhalt von XElement-und XDocument-Objekten.For details about the valid content of an XDocument, see Valid Content of XElement and XDocument Objects.

Konstruktoren

XDocument()

Initialisiert eine neue Instanz der XDocument-Klasse.Initializes a new instance of the XDocument class.

XDocument(Object[])

Initialisiert eine neue Instanz der XDocument-Klasse mit dem angegebenen Inhalt.Initializes a new instance of the XDocument class with the specified content.

XDocument(XDeclaration, Object[])

Initialisiert eine neue Instanz der XDocument-Klasse mit der angegebenen XDeclaration und dem angegebenen Inhalt.Initializes a new instance of the XDocument class with the specified XDeclaration and content.

XDocument(XDocument)

Initialisiert eine neue Instanz der XDocument-Klasse mit einem vorhandenen XDocument-Objekt.Initializes a new instance of the XDocument class from an existing XDocument object.

Eigenschaften

BaseUri

Ruft den Basis-URI für dieses XObject ab.Gets the base URI for this XObject.

(Geerbt von XObject)
Declaration

Ruft die XML-Deklaration für das Dokument ab oder legt diese fest.Gets or sets the XML declaration for this document.

Document

Ruft das XDocument für dieses XObject ab.Gets the XDocument for this XObject.

(Geerbt von XObject)
DocumentType

Ruft die Dokumenttypdefinition (DTD) für dieses Dokument ab.Gets the Document Type Definition (DTD) for this document.

FirstNode

Ruft den ersten untergeordneten Knoten dieses Knotens ab.Gets the first child node of this node.

(Geerbt von XContainer)
LastNode

Ruft den letzten untergeordneten Knoten dieses Knotens ab.Gets the last child node of this node.

(Geerbt von XContainer)
NextNode

Ruft den nächsten nebengeordneten Knoten dieses Knotens ab.Gets the next sibling node of this node.

(Geerbt von XNode)
NodeType

Ruft den Knotentyp für diesen Knoten ab.Gets the node type for this node.

Parent

Ruft das übergeordnete XElement dieses XObject ab.Gets the parent XElement of this XObject.

(Geerbt von XObject)
PreviousNode

Ruft den vorherigen nebengeordneten Knoten dieses Knotens ab.Gets the previous sibling node of this node.

(Geerbt von XNode)
Root

Ruft das Stammelement der XML-Struktur für dieses Dokument ab.Gets the root element of the XML Tree for this document.

Methoden

Add(Object)

Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu.Adds the specified content as children of this XContainer.

(Geerbt von XContainer)
Add(Object[])

Fügt den angegebenen Inhalt als untergeordnete Elemente dieses XContainer hinzu.Adds the specified content as children of this XContainer.

(Geerbt von XContainer)
AddAfterSelf(Object)

Fügt den angegebenen Inhalt unmittelbar hinter diesem Knoten hinzu.Adds the specified content immediately after this node.

(Geerbt von XNode)
AddAfterSelf(Object[])

Fügt den angegebenen Inhalt unmittelbar hinter diesem Knoten hinzu.Adds the specified content immediately after this node.

(Geerbt von XNode)
AddAnnotation(Object)

Fügt der Anmerkungsliste dieses XObject ein Objekt hinzu.Adds an object to the annotation list of this XObject.

(Geerbt von XObject)
AddBeforeSelf(Object)

Fügt den angegebenen Inhalt direkt vor diesem Knoten hinzu.Adds the specified content immediately before this node.

(Geerbt von XNode)
AddBeforeSelf(Object[])

Fügt den angegebenen Inhalt direkt vor diesem Knoten hinzu.Adds the specified content immediately before this node.

(Geerbt von XNode)
AddFirst(Object)

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.Adds the specified content as the first children of this document or element.

(Geerbt von XContainer)
AddFirst(Object[])

Fügt den angegebenen Inhalt als erste untergeordnete Elemente dieses Dokuments oder Elements hinzu.Adds the specified content as the first children of this document or element.

(Geerbt von XContainer)
Ancestors()

Gibt eine Auflistung der übergeordneten Elemente dieses Knotens zurück.Returns a collection of the ancestor elements of this node.

(Geerbt von XNode)
Ancestors(XName)

Gibt eine gefilterte Auflistung der übergeordneten Elemente dieses Knotens zurück.Returns a filtered collection of the ancestor elements of this node. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

(Geerbt von XNode)
Annotation(Type)

Ruft das erste Anmerkungsobjekt des angegebenen Typs aus diesem XObject ab.Gets the first annotation object of the specified type from this XObject.

(Geerbt von XObject)
Annotation<T>()

Ruft das erste Anmerkungsobjekt des angegebenen Typs aus diesem XObject ab.Gets the first annotation object of the specified type from this XObject.

(Geerbt von XObject)
Annotations(Type)

Ruft eine Auflistung von Anmerkungen des angegebenen Typs für dieses XObject ab.Gets a collection of annotations of the specified type for this XObject.

(Geerbt von XObject)
Annotations<T>()

Ruft eine Auflistung von Anmerkungen des angegebenen Typs für dieses XObject ab.Gets a collection of annotations of the specified type for this XObject.

(Geerbt von XObject)
CreateReader()

Erstellt einen XmlReader für diesen Knoten.Creates an XmlReader for this node.

(Geerbt von XNode)
CreateReader(ReaderOptions)

Erstellt einen XmlReader mit den im readerOptions-Parameter angegebenen Optionen.Creates an XmlReader with the options specified by the readerOptions parameter.

(Geerbt von XNode)
CreateWriter()

Erstellt einen XmlWriter, der zum Hinzufügen von Knoten zu dem XContainer verwendet werden kann.Creates an XmlWriter that can be used to add nodes to the XContainer.

(Geerbt von XContainer)
DescendantNodes()

Gibt eine Auflistung der Nachfolgerknoten für dieses Dokument oder Element in Dokumentreihenfolge zurück.Returns a collection of the descendant nodes for this document or element, in document order.

(Geerbt von XContainer)
Descendants()

Gibt eine Auflistung der Nachfolgerelemente für dieses Dokument oder Element in Dokumentreihenfolge zurück.Returns a collection of the descendant elements for this document or element, in document order.

(Geerbt von XContainer)
Descendants(XName)

Gibt eine gefilterte Auflistung der Nachfolgerelemente für dieses Dokument oder Element in Dokumentreihenfolge zurück.Returns a filtered collection of the descendant elements for this document or element, in document order. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

(Geerbt von XContainer)
Element(XName)

Ruft das erste (in Dokumentreihenfolge) untergeordnete Element mit dem angegebenen XName ab.Gets the first (in document order) child element with the specified XName.

(Geerbt von XContainer)
Elements()

Gibt eine Auflistung der untergeordneten Elemente dieses Dokuments oder Elements in Dokumentreihenfolge zurück.Returns a collection of the child elements of this element or document, in document order.

(Geerbt von XContainer)
Elements(XName)

Gibt eine gefilterte Auflistung der untergeordneten Elemente dieses Dokuments oder Elements in Dokumentreihenfolge zurück.Returns a filtered collection of the child elements of this element or document, in document order. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

(Geerbt von XContainer)
ElementsAfterSelf()

Gibt eine Auflistung der nebengeordneten Elemente nach diesem Knoten in Dokumentreihenfolge zurück.Returns a collection of the sibling elements after this node, in document order.

(Geerbt von XNode)
ElementsAfterSelf(XName)

Gibt eine gefilterte Auflistung der nebengeordneten Elemente nach diesem Knoten in Dokumentreihenfolge zurück.Returns a filtered collection of the sibling elements after this node, in document order. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

(Geerbt von XNode)
ElementsBeforeSelf()

Gibt eine Auflistung der nebengeordneten Elemente vor diesem Knoten in Dokumentreihenfolge zurück.Returns a collection of the sibling elements before this node, in document order.

(Geerbt von XNode)
ElementsBeforeSelf(XName)

Gibt eine gefilterte Auflistung der nebengeordneten Elemente vor diesem Knoten in Dokumentreihenfolge zurück.Returns a filtered collection of the sibling elements before this node, in document order. Nur Elemente, die über einen übereinstimmenden XName verfügen, sind in der Auflistung enthalten.Only elements that have a matching XName are included in the collection.

(Geerbt von XNode)
Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
IsAfter(XNode)

Bestimmt, ob der aktuelle Knoten nach einem angegebenen Knoten in der Dokumentreihenfolge angezeigt wird.Determines if the current node appears after a specified node in terms of document order.

(Geerbt von XNode)
IsBefore(XNode)

Bestimmt, ob der aktuelle Knoten vor einem angegebenen Knoten in der Dokumentreihenfolge angezeigt wird.Determines if the current node appears before a specified node in terms of document order.

(Geerbt von XNode)
Load(Stream)

Erstellt mit dem angegebenen Stream eine neue XDocument-Instanz.Creates a new XDocument instance by using the specified stream.

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.Creates a new XDocument instance by using the specified stream, optionally preserving white space, setting the base URI, and retaining line information.

Load(String)

Erstellt ein neues XDocument aus einer Datei.Creates a new XDocument from a file.

Load(String, LoadOptions)

Erstellt ein neues XDocument aus einer Datei, wobei optional Leerraum und Zeileninformationen beibehalten werden und der Basis-URI festgelegt wird.Creates a new XDocument from a file, optionally preserving white space, setting the base URI, and retaining line information.

Load(TextReader)

Erstellt ein neues XDocument aus einem TextReader.Creates a new XDocument from a TextReader.

Load(TextReader, LoadOptions)

Erstellt ein neues XDocument aus einem TextReader, wobei optional Leerraum und Zeileninformationen beibehalten werden und der Basis-URI festgelegt wird.Creates a new XDocument from a TextReader, optionally preserving white space, setting the base URI, and retaining line information.

Load(XmlReader)

Erstellt ein neues XDocument aus einem XmlReader.Creates a new XDocument from an XmlReader.

Load(XmlReader, LoadOptions)

Lädt ein XDocument aus einem XmlReader, wobei optional der Basis-URI festgelegt wird und die Zeileninformationen beibehalten werden.Loads an XDocument from an XmlReader, optionally setting the base URI, and retaining line information.

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.Asynchronously creates a new XDocument and initializes its underlying XML tree from the specified stream, optionally preserving white space.

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.Creates a new XDocument and initializes its underlying XML tree using the specified TextReader parameter, optionally preserving white space.

LoadAsync(XmlReader, LoadOptions, CancellationToken)

Erstellt ein neues XDocument, das den Inhalt des angegebenen XmlReader enthält.Creates a new XDocument containing the contents of the specified XmlReader.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
Nodes()

Gibt eine Auflistung der untergeordneten Knoten dieses Dokuments oder Elements in Dokumentreihenfolge zurück.Returns a collection of the child nodes of this element or document, in document order.

(Geerbt von XContainer)
NodesAfterSelf()

Gibt eine Auflistung der nebengeordneten Knoten nach diesem Knoten in Dokumentreihenfolge zurück.Returns a collection of the sibling nodes after this node, in document order.

(Geerbt von XNode)
NodesBeforeSelf()

Gibt eine Auflistung der nebengeordneten Knoten vor diesem Knoten in Dokumentreihenfolge zurück.Returns a collection of the sibling nodes before this node, in document order.

(Geerbt von XNode)
Parse(String)

Erstellt ein neues XDocument aus einer Zeichenfolge.Creates a new XDocument from a string.

Parse(String, LoadOptions)

Erstellt ein neues XDocument aus einer Zeichenfolge, wobei optional Leerraum und Zeileninformationen beibehalten werden und der Basis-URI festgelegt wird.Creates a new XDocument from a string, optionally preserving white space, setting the base URI, and retaining line information.

Remove()

Entfernt diesen Knoten aus seinem übergeordneten Element.Removes this node from its parent.

(Geerbt von XNode)
RemoveAnnotations(Type)

Entfernt die Anmerkungen vom angegebenen Typ aus diesem XObject.Removes the annotations of the specified type from this XObject.

(Geerbt von XObject)
RemoveAnnotations<T>()

Entfernt die Anmerkungen vom angegebenen Typ aus diesem XObject.Removes the annotations of the specified type from this XObject.

(Geerbt von XObject)
RemoveNodes()

Entfernt die untergeordneten Knoten aus diesem Dokument oder Element.Removes the child nodes from this document or element.

(Geerbt von XContainer)
ReplaceNodes(Object)

Ersetzt die untergeordneten Knoten dieses Dokuments oder Elements durch den angegebenen Inhalt.Replaces the children nodes of this document or element with the specified content.

(Geerbt von XContainer)
ReplaceNodes(Object[])

Ersetzt die untergeordneten Knoten dieses Dokuments oder Elements durch den angegebenen Inhalt.Replaces the children nodes of this document or element with the specified content.

(Geerbt von XContainer)
ReplaceWith(Object)

Ersetzt diesen Knoten durch den angegebenen Inhalt.Replaces this node with the specified content.

(Geerbt von XNode)
ReplaceWith(Object[])

Ersetzt diesen Knoten durch den angegebenen Inhalt.Replaces this node with the specified content.

(Geerbt von XNode)
Save(Stream)

Gibt diesen XDocument an den angegebenen Stream aus.Outputs this XDocument to the specified Stream.

Save(Stream, SaveOptions)

Gibt dieses XDocument zum angegebenen Stream aus und gibt Formatierungsverhalten optional an.Outputs this XDocument to the specified Stream, optionally specifying formatting behavior.

Save(String)

Serialisieren Sie dieses XDocument in eine Datei, und überschreiben Sie dabei eine vorhandene Datei, sofern vorhanden.Serialize this XDocument to a file, overwriting an existing file, if it exists.

Save(String, SaveOptions)

Serialisiert dieses XDocument in eine Datei, wobei optional die Formatierung deaktiviert wird.Serialize this XDocument to a file, optionally disabling formatting.

Save(TextWriter)

Serialisiert dieses XDocument in einen TextWriter.Serialize this XDocument to a TextWriter.

Save(TextWriter, SaveOptions)

Serialisiert dieses XDocument in einen TextWriter, wobei optional die Formatierung deaktiviert wird.Serialize this XDocument to a TextWriter, optionally disabling formatting.

Save(XmlWriter)

Serialisiert dieses XDocument in einen XmlWriter.Serialize this XDocument to an XmlWriter.

SaveAsync(Stream, SaveOptions, CancellationToken)

Geben Sie dieses XDocument in einen Stream aus.Output this XDocument to a Stream.

SaveAsync(TextWriter, SaveOptions, CancellationToken)

Schreibt dieses XDocument in einen TextWriter.Writes this XDocument to a TextWriter.

SaveAsync(XmlWriter, CancellationToken)

Schreibt dieses XDocument in einen XmlWriter.Writes this XDocument to an XmlWriter.

ToString()

Gibt das eingezogene XML für diesen Knoten zurück.Returns the indented XML for this node.

(Geerbt von XNode)
ToString(SaveOptions)

Gibt das XML für diesen Knoten zurück, wobei optional die Formatierung deaktiviert wird.Returns the XML for this node, optionally disabling formatting.

(Geerbt von XNode)
WriteTo(XmlWriter)

Schreibt dieses Dokument in einen XmlWriter.Write this document to an XmlWriter.

WriteToAsync(XmlWriter, CancellationToken)

Schreibt die zugrunde liegende XML-Struktur dieser XDocument-Instanz in den angegebenen XmlWriter.Writes this XDocument's underlying XML tree to the specified XmlWriter.

Ereignisse

Changed

Wird ausgelöst, wenn dieses XObject oder eines seiner untergeordneten Elemente geändert wurde.Raised when this XObject or any of its descendants have changed.

(Geerbt von XObject)
Changing

Wird ausgelöst, wenn dieses XObject oder eines seiner untergeordneten Elemente gerade geändert wird.Raised when this XObject or any of its descendants are about to change.

(Geerbt von XObject)

Explizite Schnittstellenimplementierungen

IXmlLineInfo.HasLineInfo()

Ruft einen Wert ab, der angibt, ob dieses XObject Zeileninformationen aufweist.Gets a value indicating whether or not this XObject has line information.

(Geerbt von XObject)
IXmlLineInfo.LineNumber

Ruft die Zeilennummer ab, die der zugrunde liegende XmlReader für dieses XObject angegeben hat.Gets the line number that the underlying XmlReader reported for this XObject.

(Geerbt von XObject)
IXmlLineInfo.LinePosition

Ruft die Zeilenposition ab, die der zugrunde liegende XmlReader für dieses XObject angegeben hat.Gets the line position that the underlying XmlReader reported for this XObject.

(Geerbt von XObject)

Erweiterungsmethoden

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)

Diese Methode validiert, ob ein XDocument einer XSD in einem XmlSchemaSet entspricht.This method validates that an XDocument conforms to an XSD in an XmlSchemaSet.

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.Validates that an XDocument conforms to an XSD in an XmlSchemaSet, optionally populating the XML tree with the post-schema-validation infoset (PSVI).

CreateNavigator(XNode)

Erstellt einen XPathNavigator für einen XNode.Creates an XPathNavigator for an XNode.

CreateNavigator(XNode, XmlNameTable)

Erstellt einen XPathNavigator für einen XNode.Creates an XPathNavigator for an XNode. Die XmlNameTable ermöglicht eine effizientere Verarbeitung von XPath-Ausdrücken.The XmlNameTable enables more efficient XPath expression processing.

XPathEvaluate(XNode, String)

Wertet einen XPath-Ausdruck aus.Evaluates an XPath expression.

XPathEvaluate(XNode, String, IXmlNamespaceResolver)

Wertet einen XPath-Ausdruck aus und löst Namespacepräfixe mit dem angegebenen IXmlNamespaceResolver auf.Evaluates an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElement(XNode, String)

Wählt mithilfe eines XPath-Ausdrucks ein XElement aus.Selects an XElement using a XPath expression.

XPathSelectElement(XNode, String, IXmlNamespaceResolver)

Wählt mithilfe eines XPath-Ausdrucks ein XElement aus und löst Namespacepräfixe mit dem angegebenen IXmlNamespaceResolver auf.Selects an XElement using a XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

XPathSelectElements(XNode, String)

Wählt mithilfe eines XPath-Ausdrucks eine Auflistung von Elementen aus.Selects a collection of elements using an XPath expression.

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.Selects a collection of elements using an XPath expression, resolving namespace prefixes using the specified IXmlNamespaceResolver.

ToXPathNavigable(XNode)

Gibt einen Accessor zurück, mit dem Sie das angegebene XNode-Objekt navigieren und bearbeiten können.Returns an accessor that allows you to navigate and edit the specified XNode.

Gilt für:

Siehe auch