Sdílet prostřednictvím

XDocument Konstruktory

  • Reference

Definice

Obor názvů:
System.Xml.Linq
Sestavení:
System.Xml.XDocument.dll
Sestavení:
System.Xml.Linq.dll
Sestavení:
netstandard.dll

Inicializuje novou instanci XDocument třídy.

Přetížení

XDocument()

Inicializuje novou instanci XDocument třídy.
XDocument(Object[])

Inicializuje novou instanci XDocument třídy se zadaným obsahem.
XDocument(XDocument)

Inicializuje novou instanci XDocument třídy z existujícího XDocument objektu.
XDocument(XDeclaration, Object[])

Inicializuje novou instanci XDocument třídy se zadaným XDeclaration a obsahem.

Příklady

Následující příklad vytvoří dokument a přidá do něj komentář a prvek. Potom vytvoří další dokument pomocí výsledků dotazu.

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)

Tento příklad vytvoří následující výstup:

<!--This is a comment-->  
<Root>  
  <Child1>data1</Child1>  
  <Child2>data2</Child2>  
  <Child3>data3</Child3>  
  <Child2>data4</Child2>  
</Root>

Poznámky

Přetížené konstruktory umožňují vytvořit nový prázdný XDocument; vytvořit XDocument s určitým zadaným počátečním obsahem a vytvořit XDocument jako kopii jiného XDocument objektu.

Existuje mnoho scénářů, které vyžadují, abyste vytvořili XDocument. Místo toho můžete obvykle vytvořit stromy XML s kořenovým XElement uzlem. Pokud nemáte konkrétní požadavek na vytvoření dokumentu (například proto, že musíte vytvořit pokyny pro zpracování a komentáře na nejvyšší úrovni nebo musíte podporovat typy dokumentů), je často vhodnější použít XElement jako kořenový uzel.

Podrobnosti o platném obsahu objektu XDocumentnaleznete v tématu Platný obsah XElement a objekty XDocument.

XDocument()

Inicializuje novou instanci XDocument třídy.

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

Příklady

Následující příklad vytvoří nový dokument a pak do něj přidá komentář a prvek.

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)

Tento příklad vytvoří následující výstup:

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

Poznámky

Existuje mnoho scénářů, které vyžadují, abyste vytvořili XDocument. Místo toho můžete obvykle vytvořit stromy XML s kořenovým XElement uzlem. Pokud nemáte konkrétní požadavek na vytvoření dokumentu (například proto, že musíte vytvořit pokyny pro zpracování a komentáře na nejvyšší úrovni nebo musíte podporovat typy dokumentů), je často vhodnější použít XElement jako kořenový uzel.

Podrobnosti o platném obsahu objektu XDocumentnaleznete v tématu Platný obsah XElement a objekty XDocument.

Viz také

Platí pro

XDocument(Object[])

Inicializuje novou instanci XDocument třídy se zadaným obsahem.

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

Parametry

content
Object[]

Seznam parametrů objektů obsahu, které chcete přidat do tohoto dokumentu.

Příklady

Následující příklad vytvoří dokument a přidá do něj komentář a prvek. Potom vytvoří další dokument pomocí výsledků dotazu.

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)

Tento příklad vytvoří následující výstup:

<!--This is a comment-->  
<Root>  
  <Child1>data1</Child1>  
  <Child2>data2</Child2>  
  <Child3>data3</Child3>  
  <Child2>data4</Child2>  
</Root>

Poznámky

Existuje mnoho scénářů, které vyžadují, abyste vytvořili XDocument. Místo toho můžete obvykle vytvořit stromy XML s kořenovým XElement uzlem. Pokud nemáte konkrétní požadavek na vytvoření dokumentu (například proto, že musíte vytvořit pokyny pro zpracování a komentáře na nejvyšší úrovni nebo musíte podporovat typy dokumentů), je často vhodnější použít XElement jako kořenový uzel.

Podrobnosti o platném obsahu objektu XDocumentnaleznete v tématu Platný obsah XElement a objekty XDocument.

Viz také

Platí pro

XDocument(XDocument)

Inicializuje novou instanci XDocument třídy z existujícího XDocument objektu.

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)

Parametry

other
XDocument

Objekt XDocument , který se zkopíruje.

Poznámky

Pomocí tohoto konstruktoru vytvoříte hlubokou kopii XDocument.

Tento konstruktor prochází všemi uzly a atributy v dokumentu zadaném v parametru other a vytváří kopie všech uzlů, protože sestavuje nově inicializované XDocument.

Viz také

Platí pro

XDocument(XDeclaration, Object[])

Inicializuje novou instanci XDocument třídy se zadaným XDeclaration a obsahem.

public:
 XDocument(System::Xml::Linq::XDeclaration ^ declaration, ... cli::array <System::Object ^> ^ content);
public XDocument (System.Xml.Linq.XDeclaration declaration, params object[] content);
public XDocument (System.Xml.Linq.XDeclaration? declaration, params 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())

Parametry

declaration
XDeclaration

Dokument XDeclaration je určený pro dokument.

content
Object[]

Obsah dokumentu.

Příklady

Následující příklad používá tento konstruktor k vytvoření dokumentu.

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"))

Tento příklad vytvoří následující výstup:

<?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>

Poznámky

Existuje mnoho scénářů, které vyžadují, abyste vytvořili XDocument. Místo toho můžete obvykle vytvořit stromy XML s kořenovým XElement uzlem. Pokud nemáte konkrétní požadavek na vytvoření dokumentu (například proto, že musíte vytvořit pokyny pro zpracování a komentáře na nejvyšší úrovni nebo musíte podporovat typy dokumentů), je často vhodnější použít XElement jako kořenový uzel.

Podrobnosti o platném obsahu objektu XDocumentnaleznete v tématu Platný obsah XElement a objekty XDocument.

Viz také

Platí pro