XDocument Konstruktory

Definice

Obor názvů:

System.Xml.Linq

Sestavení:

netstandard.dll, System.Xml.XDocument.dll

Inicializuje novou instanci XDocument třídy.

Přetížení

Name	Description
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 pak do něj přidá komentář a prvek. Potom vytvoří jiný 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 stromy XML obvykle vytvářet pomocí kořenového uzlu XElement. Pokud nemáte konkrétní požadavek na vytvoření dokumentu (například proto, že musíte vytvořit pokyny ke 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 XDocument, naleznete v části Platný obsah XElement a XDocument Objects.

XDocument()

Zdroj:

XDocument.cs

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 stromy XML obvykle vytvářet pomocí kořenového uzlu XElement. Pokud nemáte konkrétní požadavek na vytvoření dokumentu (například proto, že musíte vytvořit pokyny ke 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 XDocument, naleznete v části Platný obsah XElement a XDocument Objects.

Viz také

• Load
• Přehled LINQ to XML
• Přehled třídy XDocument

XDocument(Object[])

Zdroj:

XDocument.cs

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

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

Parametry

content

Object[]

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

Příklady

Následující příklad vytvoří dokument a pak do něj přidá komentář a prvek. Potom vytvoří jiný 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 stromy XML obvykle vytvářet pomocí kořenového uzlu XElement. Pokud nemáte konkrétní požadavek na vytvoření dokumentu (například proto, že musíte vytvořit pokyny ke 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 XDocument, naleznete v části Platný obsah XElement a XDocument Objects.

Viz také

• Load
• Přehled LINQ to XML
• Přehled třídy XDocument

XDocument(XDocument)

Zdroj:

XDocument.cs

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

Tento konstruktor použijete k vytvoření hloubkové XDocumentkopie .

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

Viz také

• Load
• Přehled LINQ to XML
• Přehled třídy XDocument

XDocument(XDeclaration, Object[])

Zdroj:

XDocument.cs

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

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 .

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 stromy XML obvykle vytvářet pomocí kořenového uzlu XElement. Pokud nemáte konkrétní požadavek na vytvoření dokumentu (například proto, že musíte vytvořit pokyny ke 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 XDocument, naleznete v části Platný obsah XElement a XDocument Objects.

Viz také

• Load
• Přehled LINQ to XML
• Přehled třídy XDocument