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

Ссылка

Определение

Пространство имен:: System.Xml.Linq

Сборка:: System.Xml.XDocument.dll

Сборка:: System.Xml.Linq.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

Перегрузки

XElement(XElement)	Инициализирует новый экземпляр класса XElement из другого объекта XElement.
XElement(XName)	Инициализирует новый экземпляр класса XElement с указанным именем.
XElement(XStreamingElement)	Инициализирует новый экземпляр класса XElement из объекта XStreamingElement.
XElement(XName, Object)	Инициализирует новый экземпляр класса XElement с указанными именем и содержимым.
XElement(XName, Object[])	Инициализирует новый экземпляр класса XElement с указанными именем и содержимым.

Примеры

В следующем примере создается XML-дерево. Содержимое нового элемента поступает из запроса LINQ.

XElement xmlTree1 = new XElement("Root",
    new XElement("Child", 1),
    new XElement("Child", 2),
    new XElement("Child", 3),
    new XElement("Child", 4),
    new XElement("Child", 5),
    new XElement("Child", 6)
);

XElement xmlTree2 = new XElement("Root",
    from el in xmlTree1.Elements()
    where((int)el >= 3 && (int)el <= 5)
    select el
);
Console.WriteLine(xmlTree2);

Dim xmlTree1 As XElement = _
        <Root>
            <Child>1</Child>
            <Child>2</Child>
            <Child>3</Child>
            <Child>4</Child>
            <Child>5</Child>
            <Child>6</Child>
        </Root>

Dim xmlTree2 As XElement = _
    <Root>
        <%= From el In xmlTree1.Elements() _
            Where el.Value >= 3 And el.Value <= 5 _
            Select el %>
    </Root>

Console.WriteLine(xmlTree2)

В этом примере выводятся следующие данные:

XML

<Root>
  <Child>3</Child>
  <Child>4</Child>
  <Child>5</Child>
</Root>

При создании элемента в пространстве имен обычно используется перегрузка оператора сложения с XNamespace и строкой для создания XName. Дополнительные сведения см. в статье Работа с пространствами имен XML.

XElement(XElement)

Исходный код:: XElement.cs

Исходный код:: XElement.cs

Исходный код:: XElement.cs

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

public:
 XElement(System::Xml::Linq::XElement ^ other);

public XElement (System.Xml.Linq.XElement other);

new System.Xml.Linq.XElement : System.Xml.Linq.XElement -> System.Xml.Linq.XElement

Public Sub New (other As XElement)

Параметры

other: XElement

Объект XElement для копирования.

Примеры

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

XElement xmlTree = new XElement("Root",
    new XAttribute("Att1", 1),
    new XElement("Child1", 1),
    new XElement("Child2", 2)
);

// Create a clone of the tree.
XElement treeClone = new XElement(xmlTree);

Console.WriteLine("xmlTree = treeClone: {0}", XNode.DeepEquals(xmlTree, treeClone));

// Do some work with xmlTree, perhaps pass it to other methods.
xmlTree.Add(new XElement("Child3", 3));

Console.WriteLine("xmlTree = treeClone: {0}", XNode.DeepEquals(xmlTree, treeClone));

Dim xmlTree As XElement = _
        <Root Att1="1">
            <Child1>1</Child1>
            <Child2>2</Child2>
        </Root>

' Create a clone of the tree.
Dim treeClone As XElement = New XElement(xmlTree)

Console.WriteLine("xmlTree = treeClone: {0}", XNode.DeepEquals(xmlTree, treeClone))

' Do some work with xmlTree, perhaps pass it to other methods.
xmlTree.Add(New XElement("Child3", 3))

Console.WriteLine("xmlTree = treeClone: {0}", XNode.DeepEquals(xmlTree, treeClone))

В этом примере выводятся следующие данные:

xmlTree = treeClone: True
xmlTree = treeClone: False

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

Общие сведения о LINQ to XML

Применяется к

XElement(XName)

Исходный код:: XElement.cs

Исходный код:: XElement.cs

Исходный код:: XElement.cs

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

public:
 XElement(System::Xml::Linq::XName ^ name);

public XElement (System.Xml.Linq.XName name);

new System.Xml.Linq.XElement : System.Xml.Linq.XName -> System.Xml.Linq.XElement

Public Sub New (name As XName)

Параметры

name: XName

XName, содержащий имя элемента.

Примеры

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

XElement el = new XElement("Root");
Console.WriteLine(el);

Dim el As XElement = <Root/>
Console.WriteLine(el)

В этом примере выводятся следующие данные:

XML

<Root />

В следующем примере создается элемент в пространстве имен без содержимого. Дополнительные сведения см. в статье Работа с пространствами имен XML.

XNamespace aw = "http://www.adventure-works.com";
XElement root = new XElement(aw + "Root");
Console.WriteLine(root);

Imports <xmlns="http://www.adventure-works.com">

Module Module1
    Sub Main()
        Dim root = <Root/>
        Console.WriteLine(root)
    End Sub
End Module

В этом примере выводятся следующие данные:

XML

<Root xmlns="http://www.adventure-works.com" />

Существует неявное преобразование из строки в XName. Обычно этот конструктор используется для указания строки в качестве параметра вместо создания нового XName. При создании элемента в пространстве имен обычно используется перегрузка оператора сложения с XNamespace и строкой для создания XName. Дополнительные сведения см. в статье Работа с пространствами имен XML.

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

Общие сведения о LINQ to XML

Применяется к

XElement(XStreamingElement)

Исходный код:: XElement.cs

Исходный код:: XElement.cs

Исходный код:: XElement.cs

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

public:
 XElement(System::Xml::Linq::XStreamingElement ^ other);

public XElement (System.Xml.Linq.XStreamingElement other);

new System.Xml.Linq.XElement : System.Xml.Linq.XStreamingElement -> System.Xml.Linq.XElement

Public Sub New (other As XStreamingElement)

Параметры

other: XStreamingElement

Элемент XStreamingElement, содержащий невычисленные запросы, итерации которых будут выполнены для содержимого XElement.

Примеры

В следующем примере создается исходное XML-дерево, а затем создается XStreamingElement из запроса к исходному XML-дереву. Затем он сериализует XStreamingElement в консоль, добавляет новый элемент в исходное XML-дерево, а затем сериализует XStreamingElement снова. Вы видите, что элемент, добавленный в исходное XML-дерево, не включается в первую сериализацию, а включается во вторую.

XElement src = new XElement("Root",
                   new XElement("Child1", 1),
                   new XElement("Child2", 2),
                   new XElement("Child3", 3)
               );
XStreamingElement xse = new XStreamingElement("NewRoot",
                            from el in src.Elements()
                            where (int)el >= 2
                            select el
                        );
Console.WriteLine(xse);
src.Add(new XElement("Child4", 4));
Console.WriteLine("----");
Console.WriteLine(xse);

Dim src As XElement = _
        <Root>
            <Child1>1</Child1>
            <Child2>2</Child2>
            <Child3>3</Child3>
        </Root>
Dim xse As XStreamingElement = New XStreamingElement("NewRoot", _
        From el In src.Elements() _
        Where (CInt(el) >= 2) _
        Select el _
)
Console.WriteLine(xse)
src.Add(New XElement("Child4", 4))
Console.WriteLine("----")
Console.WriteLine(xse)

В этом примере выводятся следующие данные:

<NewRoot>
  <Child2>2</Child2>
  <Child3>3</Child3>
</NewRoot>
----
<NewRoot>
  <Child2>2</Child2>
  <Child3>3</Child3>
  <Child4>4</Child4>
</NewRoot>

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

Общие сведения о LINQ to XML

Применяется к

XElement(XName, Object)

Исходный код:: XElement.cs

Исходный код:: XElement.cs

Исходный код:: XElement.cs

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

public:
 XElement(System::Xml::Linq::XName ^ name, System::Object ^ content);

public XElement (System.Xml.Linq.XName name, object content);

public XElement (System.Xml.Linq.XName name, object? content);

new System.Xml.Linq.XElement : System.Xml.Linq.XName * obj -> System.Xml.Linq.XElement

Public Sub New (name As XName, content As Object)

Параметры

name: XName

XName, содержащий имя элемента.

content: Object

Содержимое элемента.

Примеры

В следующем примере создается XML-дерево. Содержимое нового элемента поступает из запроса LINQ.

XElement xmlTree1 = new XElement("Root",
    new XElement("Child1", 1),
    new XElement("Child2", 2),
    new XElement("Child3", 3),
    new XElement("Child4", 4),
    new XElement("Child5", 5),
    new XElement("Child6", 6)
);

XElement xmlTree2 = new XElement("Root",
    from el in xmlTree1.Elements()
    where((int)el >= 3 && (int)el <= 5)
    select el
);
Console.WriteLine(xmlTree2);

Dim xmlTree1 As XElement = _
        <Root>
            <Child1>1</Child1>
            <Child2>2</Child2>
            <Child3>3</Child3>
            <Child4>4</Child4>
            <Child5>5</Child5>
            <Child6>6</Child6>
        </Root>

Dim xmlTree2 As XElement = _
    <Root>
        <%= From el In xmlTree1.Elements() _
            Where el.Value >= 3 And el.Value <= 5 _
            Select el %>
    </Root>

Console.WriteLine(xmlTree2)

В этом примере выводятся следующие данные:

XML

<Root>
  <Child3>3</Child3>
  <Child4>4</Child4>
  <Child5>5</Child5>
</Root>

В следующем примере создается XML-дерево с различными типами содержимого.

XElement root;

// String content:
root = new XElement("Root", "Some text");
Console.WriteLine(root);

// XElement object content:
root = new XElement("Root",
    new XElement("NewChild", "n")
);
Console.WriteLine(root);

// XAttribute object content:
root = new XElement("Root",
    new XAttribute("NewAttribute", "n")
);
Console.WriteLine(root);

// Double content:
double dbl = 12.345;
root = new XElement("Root", dbl);
Console.WriteLine(root);

// DateTime content:
DateTime dt = new DateTime(2006, 10, 6, 12, 30, 00);
root = new XElement("Root", dt);
Console.WriteLine(root);

// String array content:
// Any collection other than a collection of XElement or XAttribute objects
// are converted to strings. The strings are concatenated and added.
string[] stringArray = {
    "abc",
    "def",
    "ghi"
};
root = new XElement("Root", stringArray);
Console.WriteLine(root);

// XElement object array content:
XElement[] ellArray = {
    new XElement("NewChild1", 1),
    new XElement("NewChild2", 2),
    new XElement("NewChild3", 3)
};
root = new XElement("Root", ellArray);
Console.WriteLine(root);

// XAttribute object array content:
XAttribute[] attArray = {
    new XAttribute("NewAtt1", 1),
    new XAttribute("NewAtt2", 2),
    new XAttribute("NewAtt3", 3)
};
root = new XElement("Root", attArray);
Console.WriteLine(root);

Dim root As XElement

' String content:
root = <Root>Some text</Root>
Console.WriteLine(root)

' XElement object content:
root = <Root>
           <NewChild>n</NewChild>
       </Root>
Console.WriteLine(root)

' XAttribute object content:
root = <Root NewAttribute="n"/>
Console.WriteLine(root)

' Double content:
Dim dbl As Double = 12.345
root = <Root><%= dbl %></Root>
Console.WriteLine(root)

' DateTime content:
Dim dt As DateTime = New DateTime(2006, 10, 6, 12, 30, 0)
root = <Root><%= dt %></Root>
Console.WriteLine(root)

' String array content:
' Any collection other than a collection of XElement or XAttribute objects
' are converted to strings. The strings are concatenated and added.

Dim stringArray As String() = { _
    "abc", _
    "def", _
    "ghi" _
}
root = <Root><%= stringArray %></Root>
Console.WriteLine(root)

' XElement object array content:
Dim ellArray As XElement() = { _
    <NewChild1>1</NewChild1>, _
    <NewChild2>2</NewChild2>, _
    <NewChild3>3</NewChild3> _
}

root = <Root><%= ellArray %></Root>
Console.WriteLine(root)

' XAttribute object array content
Dim attArray As XAttribute() = { _
    New XAttribute("NewAtt1", 1), _
    New XAttribute("NewAtt2", 2), _
    New XAttribute("NewAtt3", 3) _
}
root = <Root><%= attArray %></Root>
Console.WriteLine(root)

В этом примере выводятся следующие данные:

XML

<Root>Some text</Root>
<Root>
  <NewChild>n</NewChild>
</Root>
<Root NewAttribute="n" />
<Root>12.345</Root>
<Root>2006-10-06T12:30:00</Root>
<Root>abcdefghi</Root>
<Root>
  <NewChild1>1</NewChild1>
  <NewChild2>2</NewChild2>
  <NewChild3>3</NewChild3>
</Root>
<Root NewAtt1="1" NewAtt2="2" NewAtt3="3" />

В следующем примере создается XML-дерево в пространстве имен.

// Create an XML tree in a namespace.
XNamespace aw = "http://www.adventure-works.com";
XElement root = new XElement(aw + "Root",
    new XElement(aw + "Child", "child content")
);
Console.WriteLine(root);

' Create an XML tree in a namespace.
Dim root As XElement = _
    <Root xmlns='http://www.adventure-works.com'>
        <Child>child content</Child>
    </Root>
Console.WriteLine(root)

В этом примере выводятся следующие данные:

XML

<Root xmlns="http://www.adventure-works.com">
  <Child>child content</Child>
</Root>

В следующем примере создается XML-дерево с вложенными пространствами имен.

// Create an XML tree with nested namespaces.
XNamespace aw = "http://www.adventure-works.com";
XNamespace fc = "www.fourthcoffee.com";
XDocument root = new XDocument(
    new XDeclaration("1.0", "utf-8", "yes"),
    new XElement(aw + "Root",
        new XElement(fc + "Child",
            new XElement(aw + "DifferentChild", "other content")
        )
    )
);
Console.WriteLine(root);

' Create an XML tree with nested namespaces.
Dim root As XDocument = _
    <?xml version='1.0'?>
    <Root xmlns='http://www.adventure-works.com'>
        <Child xmlns='www.fourthcoffee.com'>
        <DifferentChild xmlns='http://www.adventure-works.com'>other content</DifferentChild>
        </Child>
    </Root>
Console.WriteLine(root)

В этом примере выводятся следующие данные:

XML

<Root xmlns="http://www.adventure-works.com">
  <Child xmlns="www.fourthcoffee.com">
    <DifferentChild xmlns="http://www.adventure-works.com">other content</DifferentChild>
  </Child>
</Root>

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

Общие сведения о LINQ to XML

Применяется к

XElement(XName, Object[])

Исходный код:: XElement.cs

Исходный код:: XElement.cs

Исходный код:: XElement.cs

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

public:
 XElement(System::Xml::Linq::XName ^ name, ... cli::array <System::Object ^> ^ content);

public XElement (System.Xml.Linq.XName name, params object[] content);

public XElement (System.Xml.Linq.XName name, params object?[] content);

new System.Xml.Linq.XElement : System.Xml.Linq.XName * obj[] -> System.Xml.Linq.XElement

Public Sub New (name As XName, ParamArray content As Object())

Параметры

name: XName

XName, содержащий имя элемента.

content: Object[]

Начальное содержимое элемента.

Примеры

В следующем примере создается XML-дерево. Содержимое нового элемента поступает из запроса LINQ.

XElement xmlTree1 = new XElement("Root",
    new XElement("Child1", 1),
    new XElement("Child2", 2),
    new XElement("Child3", 3),
    new XElement("Child4", 4),
    new XElement("Child5", 5),
    new XElement("Child6", 6)
);

XElement xmlTree2 = new XElement("Root",
    from el in xmlTree1.Elements()
    where((int)el >= 3 && (int)el <= 5)
    select el
);
Console.WriteLine(xmlTree2);

Dim xmlTree1 As XElement = _
        <Root>
            <Child1>1</Child1>
            <Child2>2</Child2>
            <Child3>3</Child3>
            <Child4>4</Child4>
            <Child5>5</Child5>
            <Child6>6</Child6>
        </Root>

Dim xmlTree2 As XElement = _
    <Root>
        <%= From el In xmlTree1.Elements() _
            Where el.Value >= 3 And el.Value <= 5 _
            Select el %>
    </Root>

Console.WriteLine(xmlTree2)

В этом примере выводятся следующие данные:

XML

<Root>
  <Child3>3</Child3>
  <Child4>4</Child4>
  <Child5>5</Child5>
</Root>

В следующем примере создается XML-дерево с различными типами содержимого.

XElement root;

// String content:
root = new XElement("Root", "Some text");
Console.WriteLine(root);

// XElement object content:
root = new XElement("Root",
    new XElement("NewChild", "n")
);
Console.WriteLine(root);

// XAttribute object content:
root = new XElement("Root",
    new XAttribute("NewAttribute", "n")
);
Console.WriteLine(root);

// Double content:
double dbl = 12.345;
root = new XElement("Root", dbl);
Console.WriteLine(root);

// DateTime content:
DateTime dt = new DateTime(2006, 10, 6, 12, 30, 00);
root = new XElement("Root", dt);
Console.WriteLine(root);

// String array content:
// Any collection other than a collection of XElement or XAttribute objects
// are converted to strings. The strings are concatenated and added.
string[] stringArray = {
    "abc",
    "def",
    "ghi"
};
root = new XElement("Root", stringArray);
Console.WriteLine(root);

// XElement object array content:
XElement[] ellArray = {
    new XElement("NewChild1", 1),
    new XElement("NewChild2", 2),
    new XElement("NewChild3", 3)
};
root = new XElement("Root", ellArray);
Console.WriteLine(root);

// XAttribute object array content:
XAttribute[] attArray = {
    new XAttribute("NewAtt1", 1),
    new XAttribute("NewAtt2", 2),
    new XAttribute("NewAtt3", 3)
};
root = new XElement("Root", attArray);
Console.WriteLine(root);

Dim root As XElement

' String content:
root = <Root>Some text</Root>
Console.WriteLine(root)

' XElement object content:
root = <Root>
           <NewChild>n</NewChild>
       </Root>
Console.WriteLine(root)

' XAttribute object content:
root = <Root NewAttribute="n"/>
Console.WriteLine(root)

' Double content:
Dim dbl As Double = 12.345
root = <Root><%= dbl %></Root>
Console.WriteLine(root)

' DateTime content:
Dim dt As DateTime = New DateTime(2006, 10, 6, 12, 30, 0)
root = <Root><%= dt %></Root>
Console.WriteLine(root)

' String array content:
' Any collection other than a collection of XElement or XAttribute objects
' are converted to strings. The strings are concatenated and added.

Dim stringArray As String() = { _
    "abc", _
    "def", _
    "ghi" _
}
root = <Root><%= stringArray %></Root>
Console.WriteLine(root)

' XElement object array content:
Dim ellArray As XElement() = { _
    <NewChild1>1</NewChild1>, _
    <NewChild2>2</NewChild2>, _
    <NewChild3>3</NewChild3> _
}

root = <Root><%= ellArray %></Root>
Console.WriteLine(root)

' XAttribute object array content
Dim attArray As XAttribute() = { _
    New XAttribute("NewAtt1", 1), _
    New XAttribute("NewAtt2", 2), _
    New XAttribute("NewAtt3", 3) _
}
root = <Root><%= attArray %></Root>
Console.WriteLine(root)

В этом примере выводятся следующие данные:

XML

<Root>Some text</Root>
<Root>
  <NewChild>n</NewChild>
</Root>
<Root NewAttribute="n" />
<Root>12.345</Root>
<Root>2006-10-06T12:30:00</Root>
<Root>abcdefghi</Root>
<Root>
  <NewChild1>1</NewChild1>
  <NewChild2>2</NewChild2>
  <NewChild3>3</NewChild3>
</Root>
<Root NewAtt1="1" NewAtt2="2" NewAtt3="3" />

В следующем примере создается XML-дерево в пространстве имен.

// Create an XML tree in a namespace.
XNamespace aw = "http://www.adventure-works.com";
XElement root = new XElement(aw + "Root",
    new XElement(aw + "Child", "child content")
);
Console.WriteLine(root);

' Create an XML tree in a namespace.
Dim root As XElement = _
    <Root xmlns='http://www.adventure-works.com'>
        <Child>child content</Child>
    </Root>
Console.WriteLine(root)

В этом примере выводятся следующие данные:

XML

<Root xmlns="http://www.adventure-works.com">
  <Child>child content</Child>
</Root>

В следующем примере создается XML-дерево с вложенными пространствами имен.

// Create an XML tree with nested namespaces.
XNamespace aw = "http://www.adventure-works.com";
XNamespace fc = "www.fourthcoffee.com";
XElement root = new XElement(aw + "Root",
    new XElement(fc + "Child",
        new XElement(aw + "DifferentChild", "other content")
    )
);
Console.WriteLine(root);

' Create an XML tree with nested namespaces.
Dim root As XDocument = _
    <?xml version='1.0'?>
    <Root xmlns='http://www.adventure-works.com'>
        <Child xmlns='www.fourthcoffee.com'>
        <DifferentChild xmlns='http://www.adventure-works.com'>other content</DifferentChild>
        </Child>
    </Root>
Console.WriteLine(root)

В этом примере выводятся следующие данные:

XML

<Root xmlns="http://www.adventure-works.com">
  <Child xmlns="www.fourthcoffee.com">
    <DifferentChild xmlns="http://www.adventure-works.com">other content</DifferentChild>
  </Child>
</Root>

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

Общие сведения о LINQ to XML

Применяется к

Совместная работа с нами на GitHub

Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.

Отзыв о .NET

.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:

Открыть проблему с документацией Отзыв о продукте

Будущее в ваших руках

Поделиться через

Определение

Перегрузки

Примеры

Комментарии

XElement(XElement)

Параметры

Примеры

Комментарии

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

Применяется к

XElement(XName)

Параметры

Примеры

Комментарии

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

Применяется к

XElement(XStreamingElement)

Параметры

Примеры

Комментарии

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

Применяется к

XElement(XName, Object)

Параметры

Примеры

Комментарии

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

Применяется к

XElement(XName, Object[])

Параметры

Примеры

Комментарии

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

Применяется к