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

這個範例會產生下列輸出：

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

備註

如需可傳遞至此建構函式之有效內容的詳細資訊，請參閱 XElement 和 XDocument 物件的有效內容。

有從字串到 XName 的隱含轉換。此建構函式的一般用法是將字串指定為參數，而不是建立新的 XName 。

在命名空間中建立專案時，一般用法是使用加法運算子多載搭配和 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)

這個範例會產生下列輸出：

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

來源:: 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 樹狀結構，然後從來源 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)

來源:: 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)

這個範例會產生下列輸出：

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

來源:: 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)

這個範例會產生下列輸出：

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

參數

範例

備註

另請參閱

適用於

其他資源