XDocument Конструкторы

Определение

Пространство имен:

System.Xml.Linq

Сборки:

netstandard.dll, System.Xml.XDocument.dll

Инициализирует новый экземпляр класса XDocument.

Перегрузки

Имя	Описание
XDocument()	Инициализирует новый экземпляр класса XDocument.
XDocument(Object[])	Инициализирует новый экземпляр XDocument класса с указанным содержимым.
XDocument(XDocument)	Инициализирует новый экземпляр класса из существующего XDocumentXDocument объекта.
XDocument(XDeclaration, Object[])	Инициализирует новый экземпляр XDocument класса с указанным XDeclaration и содержимым.

Примеры

В следующем примере создается документ, а затем добавляется комментарий и элемент в него. Затем он создает другой документ с помощью результатов запроса.

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)

В примере получается следующий вывод.

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

Комментарии

Перегруженные конструкторы позволяют создать пустой XDocumentобъект; создать XDocument с определенным исходным содержимым и создать XDocument копию другого XDocument объекта.

Существует не много сценариев, требующих создания XDocument. Вместо этого вы обычно можете создавать XML-деревья с XElement корневым узлом. Если у вас нет конкретного требования к созданию документа (например, так как вам нужно создавать инструкции и комментарии на верхнем уровне или поддерживать типы документов), часто удобнее использовать XElement в качестве корневого узла.

Дополнительные сведения о XDocument".

XDocument()

Исходный код:

XDocument.cs

Инициализирует новый экземпляр класса XDocument.

public:
 XDocument();

public XDocument();

Public Sub New ()

Примеры

В следующем примере создается новый документ, а затем добавляется комментарий и элемент в него.

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)

В примере получается следующий вывод.

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

Комментарии

Существует не много сценариев, требующих создания XDocument. Вместо этого вы обычно можете создавать XML-деревья с XElement корневым узлом. Если у вас нет конкретного требования к созданию документа (например, так как вам нужно создавать инструкции и комментарии на верхнем уровне или поддерживать типы документов), часто удобнее использовать XElement в качестве корневого узла.

Дополнительные сведения о XDocument".

См. также раздел

• Load
• Обзор LINQ to XML
• Обзор класса XDocument

XDocument(Object[])

Исходный код:

XDocument.cs

Инициализирует новый экземпляр XDocument класса с указанным содержимым.

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

Параметры

content

Object[]

Список параметров объектов содержимого, добавляемых в этот документ.

Примеры

В следующем примере создается документ, а затем добавляется комментарий и элемент в него. Затем он создает другой документ с помощью результатов запроса.

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)

В примере получается следующий вывод.

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

Комментарии

Существует не много сценариев, требующих создания XDocument. Вместо этого вы обычно можете создавать XML-деревья с XElement корневым узлом. Если у вас нет конкретного требования к созданию документа (например, так как вам нужно создавать инструкции и комментарии на верхнем уровне или поддерживать типы документов), часто удобнее использовать XElement в качестве корневого узла.

Дополнительные сведения о XDocument".

См. также раздел

• Load
• Обзор LINQ to XML
• Обзор класса XDocument

XDocument(XDocument)

Исходный код:

XDocument.cs

Инициализирует новый экземпляр класса из существующего XDocumentXDocument объекта.

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)

Параметры

other

XDocument

Объект XDocument , который будет скопирован.

Комментарии

Этот конструктор используется для создания глубокой XDocumentкопии.

Этот конструктор проходит по всем узлам и атрибутам в документе, указанном в параметре other , и создает копии всех узлов по мере сборки вновь инициализированного XDocument.

См. также раздел

• Load
• Обзор LINQ to XML
• Обзор класса XDocument

XDocument(XDeclaration, Object[])

Исходный код:

XDocument.cs

Инициализирует новый экземпляр XDocument класса с указанным XDeclaration и содержимым.

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

Параметры

declaration

XDeclaration

Документ XDeclaration .

content

Object[]

Содержимое документа.

Примеры

В следующем примере этот конструктор используется для создания документа.

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

В примере получается следующий вывод.

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

Комментарии

Существует не много сценариев, требующих создания XDocument. Вместо этого вы обычно можете создавать XML-деревья с XElement корневым узлом. Если у вас нет конкретного требования к созданию документа (например, так как вам нужно создавать инструкции и комментарии на верхнем уровне или поддерживать типы документов), часто удобнее использовать XElement в качестве корневого узла.

Дополнительные сведения о XDocument".

См. также раздел

• Load
• Обзор LINQ to XML
• Обзор класса XDocument