XDocument Konstruktoren

Definition

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

Überlädt

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(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.

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.

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

Überladene Konstruktoren ermöglichen das Erstellen eines neuen XDocumentleeren, das XDocument Erstellen eines mit einem angegebenen Anfangs Inhalt und das Erstellen eines XDocument als Kopie eines anderen XDocument Objekts.Overloaded constructors enable you to create a new empty XDocument; to create an XDocument with some specified initial content; and to create an XDocument as a copy of another XDocument object.

Die Anzahl der Szenarios, in denen Sie ein XDocument erstellen müssen, ist sehr begrenzt.There are not many scenarios that require you to create an XDocument. Stattdessen können Sie i. d. R. die XML-Strukturen mit einem XElement-Stammknoten erstellen.Instead, you can usually create your XML trees with an XElement root node. Sofern es keine bestimmte Anforderung für das Erstellen eines Dokuments gibt (z. B., weil Sie Verarbeitungsanweisungen und Kommentare auf der obersten Ebene erstellen oder Dokumenttypen unterstützen müssen), ist es oft bequemer, XElement als Stammknoten zu verwenden.Unless you have a specific requirement to create a document (for example, because you have to create processing instructions and comments at the top level, or you have to support document types), it is often more convenient to use XElement as your root node.

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.

XDocument()

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

public:
 XDocument();
public XDocument ();
Public Sub New ()

Beispiele

Im folgenden Beispiel wird ein neues Dokument erstellt und dann ein Kommentar und ein-Element hinzugefügt.The following example creates a new document, and then adds a comment and an element to it.

XDocument doc = new XDocument();  
doc.Add(new XComment("This is a comment"));  
doc.Add(new XElement("Root", "content"));  
Console.WriteLine(doc);  
Dim doc As XDocument = New XDocument()  
doc.Add(<!--This is a comment-->)  
doc.Add(<Root>content</Root>)  
Console.WriteLine(doc)  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

<!--This is a comment-->  
<Root>content</Root>  

Hinweise

Die Anzahl der Szenarios, in denen Sie ein XDocument erstellen müssen, ist sehr begrenzt.There are not many scenarios that require you to create an XDocument. Stattdessen können Sie i. d. R. die XML-Strukturen mit einem XElement-Stammknoten erstellen.Instead, you can usually create your XML trees with an XElement root node. Sofern es keine bestimmte Anforderung für das Erstellen eines Dokuments gibt (z. B., weil Sie Verarbeitungsanweisungen und Kommentare auf der obersten Ebene erstellen oder Dokumenttypen unterstützen müssen), ist es oft bequemer, XElement als Stammknoten zu verwenden.Unless you have a specific requirement to create a document (for example, because you have to create processing instructions and comments at the top level, or you have to support document types), it is often more convenient to use XElement as your root node.

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.

Siehe auch

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.

public:
 XDocument(... cli::array <System::Object ^> ^ content);
public XDocument (params object[] content);
new System.Xml.Linq.XDocument : obj[] -> System.Xml.Linq.XDocument
Public Sub New (ParamArray content As Object())

Parameter

content
Object[]

Eine Parameterliste von Inhaltsobjekten, die diesem Dokument hinzugefügt werden sollen.A parameter list of content objects to add to this document.

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

Die Anzahl der Szenarios, in denen Sie ein XDocument erstellen müssen, ist sehr begrenzt.There are not many scenarios that require you to create an XDocument. Stattdessen können Sie i. d. R. die XML-Strukturen mit einem XElement-Stammknoten erstellen.Instead, you can usually create your XML trees with an XElement root node. Sofern es keine bestimmte Anforderung für das Erstellen eines Dokuments gibt (z. B., weil Sie Verarbeitungsanweisungen und Kommentare auf der obersten Ebene erstellen oder Dokumenttypen unterstützen müssen), ist es oft bequemer, XElement als Stammknoten zu verwenden.Unless you have a specific requirement to create a document (for example, because you have to create processing instructions and comments at the top level, or you have to support document types), it is often more convenient to use XElement as your root node.

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.

Siehe auch

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.

public:
 XDocument(System::Xml::Linq::XDocument ^ other);
public XDocument (System.Xml.Linq.XDocument other);
new System.Xml.Linq.XDocument : System.Xml.Linq.XDocument -> System.Xml.Linq.XDocument
Public Sub New (other As XDocument)

Parameter

other
XDocument

Das XDocument-Objekt, das kopiert wird.The XDocument object that will be copied.

Hinweise

Verwenden Sie diesen Konstruktor, um eine tiefe Kopie von XDocumentzu erstellen.You use this constructor to make a deep copy of an XDocument.

Dieser Konstruktor durchläuft alle Knoten und Attribute im Dokument, das im other -Parameter angegeben ist, und erstellt Kopien aller Knoten, während er die neu initialisierte XDocumentassembliert.This constructor traverses all nodes and attributes in the document specified in the other parameter, and creates copies of all nodes as it assembles the newly initialized XDocument.

Siehe auch

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.

public:
 XDocument(System::Xml::Linq::XDeclaration ^ declaration, ... cli::array <System::Object ^> ^ content);
public XDocument (System.Xml.Linq.XDeclaration declaration, params object[] content);
new System.Xml.Linq.XDocument : System.Xml.Linq.XDeclaration * obj[] -> System.Xml.Linq.XDocument
Public Sub New (declaration As XDeclaration, ParamArray content As Object())

Parameter

declaration
XDeclaration

Eine XDeclaration für das Dokument.An XDeclaration for the document.

content
Object[]

Der Inhalt des Dokuments.The content of the document.

Beispiele

Im folgenden Beispiel wird dieser Konstruktor verwendet, um ein Dokument zu erstellen.The following example uses this constructor to create a document.

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 XDeclaration("1.0", "utf-8", "yes"),  
    new XComment("This is a new comment"),  
    new XElement("Root",  
        from el in srcTree.Element("Root").Elements()  
        where ((string)el).StartsWith("data")  
        select el  
    )  
);  
doc.Save("Test.xml");  
Console.WriteLine(File.ReadAllText("Test.xml"));  
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 new comment-->  
        <Root>  
            <%= From el In srcTree.<Root>.Elements _  
                Where CStr(el).StartsWith("data") _  
                Select el %>  
        </Root>  
doc.Save("Test.xml")  
Console.WriteLine(File.ReadAllText("Test.xml"))  

Dieses Beispiel erzeugt die folgende Ausgabe:This example produces the following output:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>  
<!--This is a new comment-->  
<Root>  
  <Child1>data1</Child1>  
  <Child2>data2</Child2>  
  <Child3>data3</Child3>  
  <Child2>data4</Child2>  
</Root>  

Hinweise

Die Anzahl der Szenarios, in denen Sie ein XDocument erstellen müssen, ist sehr begrenzt.There are not many scenarios that require you to create an XDocument. Stattdessen können Sie i. d. R. die XML-Strukturen mit einem XElement-Stammknoten erstellen.Instead, you can usually create your XML trees with an XElement root node. Sofern es keine bestimmte Anforderung für das Erstellen eines Dokuments gibt (z. B., weil Sie Verarbeitungsanweisungen und Kommentare auf der obersten Ebene erstellen oder Dokumenttypen unterstützen müssen), ist es oft bequemer, XElement als Stammknoten zu verwenden.Unless you have a specific requirement to create a document (for example, because you have to create processing instructions and comments at the top level, or you have to support document types), it is often more convenient to use XElement as your root node.

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.

Siehe auch

Gilt für: