XElement 构造函数

参考

定义

命名空间:: System.Xml.Linq

程序集:: System.Xml.XDocument.dll

程序集:: System.Xml.Linq.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

初始化 XElement 类的新实例。

重载

XElement(XElement)	从另一个 XElement 对象初始化 XElement 类的新实例。
XElement(XName)	使用指定名称初始化 XElement 类的新实例。
XElement(XStreamingElement)	从 XStreamingElement 对象初始化 XElement 类的新实例。
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)

此示例生成以下输出：

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

注解

有关可传递给此构造函数的有效内容的详细信息，请参阅 XElement 和 XDocument 对象的有效内容。

有从字符串到 XName的隐式转换。此构造函数的典型用法是将字符串指定为参数，而不是创建新的 XName。

在命名空间中创建元素时，典型的用途是将加法运算符重载与 XNamespace 和字符串一起使用来创建 XName。有关详细信息，请参阅使用 XML 命名空间。

XElement(XElement)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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)

此示例生成以下输出：

<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

此示例生成以下输出：

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

注解

此构造函数创建不带内容和无属性的元素。

有从字符串到 XName的隐式转换。此构造函数的典型用法是将字符串指定为参数，而不是创建新的 XName。在命名空间中创建元素时，典型的用途是将加法运算符重载与 XNamespace 和字符串一起使用来创建 XName。有关详细信息，请参阅使用 XML 命名空间。

另请参阅

LINQ to XML 概述

适用于

XElement(XStreamingElement)

Source:: XElement.cs

Source:: XElement.cs

Source:: XElement.cs

从 XStreamingElement 对象初始化 XElement 类的新实例。

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 树，然后从源 XML 树上的查询创建 XStreamingElement。然后，它将 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>

注解

此构造函数循环访问指定 XStreamingElement的内容，并创建包含其内容的元素。

另请参阅

LINQ to XML 概述

适用于

XElement(XName, Object)

Source:: XElement.cs

Source:: XElement.cs

Source:: 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)

此示例生成以下输出：

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

此示例生成以下输出：

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

此示例生成以下输出：

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

此示例生成以下输出：

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

注解

此构造函数创建具有指定内容和属性的元素。

有从字符串到 XName的隐式转换。此构造函数的典型用法是将字符串指定为参数，而不是创建新的 XName。

在命名空间中创建元素时，典型的用途是将加法运算符重载与 XNamespace 和字符串一起使用来创建 XName。有关详细信息，请参阅使用 XML 命名空间。

有关可传递给此构造函数的有效内容的详细信息，请参阅 XElement 和 XDocument 对象的有效内容。

另请参阅

LINQ to XML 概述

适用于

XElement(XName, Object[])

Source:: XElement.cs

Source:: XElement.cs

Source:: 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)

此示例生成以下输出：

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

此示例生成以下输出：

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

此示例生成以下输出：

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

此示例生成以下输出：

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

注解

此构造函数创建具有指定内容和属性的元素。

有从字符串到 XName的隐式转换。此构造函数的典型用法是将字符串指定为参数，而不是创建新的 XName。

在命名空间中创建元素时，典型的用途是将加法运算符重载与 XNamespace 和字符串一起使用来创建 XName。有关详细信息，请参阅使用 XML 命名空间。

有关可传递给此构造函数的有效内容的详细信息，请参阅 XElement 和 XDocument 对象的有效内容。

另请参阅

LINQ to XML 概述

适用于

通过

XElement 构造函数

定义

重载

示例

注解

XElement(XElement)

参数

示例

注解

另请参阅

适用于

XElement(XName)

参数

示例

注解

另请参阅

适用于

XElement(XStreamingElement)

参数

示例

注解

另请参阅

适用于

XElement(XName, Object)

参数

示例

注解

另请参阅

适用于

XElement(XName, Object[])

参数

示例

注解

另请参阅

适用于

其他资源