XStreamingElement.Add 方法

定義

命名空間:

System.Xml.Linq

組件:

System.Xml.XDocument.dll

組件:

System.Xml.Linq.dll

組件:

netstandard.dll

將指定的內容當做子系加入至這個 XStreamingElement。

多載

Add(Object)	將指定的內容當做子系加入至這個 XStreamingElement。
Add(Object[])	將指定的內容當做子系加入至這個 XStreamingElement。

Add(Object)

將指定的內容當做子系加入至這個 XStreamingElement。

public:
 void Add(System::Object ^ content);

public void Add (object content);

public void Add (object? content);

member this.Add : obj -> unit

Public Sub Add (content As Object)

參數

content

Object

要加入到資料流項目的內容。

範例

下列範例會建立新的 XStreamingElement 。 然後，它會將兩個查詢新增至串流專案。 在序列化串流專案之前，查詢不會逐一查看。

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

XStreamingElement dstTree = new XStreamingElement("NewRoot");  

dstTree.Add(  
    from el in srcTree.Elements()  
    where (int)el <= 1  
    select new XElement("Child", (int)el)  
);  

dstTree.Add(  
    from el in srcTree.Elements()  
    where (int)el >= 3  
    select new XElement("DifferentChild", (int)el)  
);  

Console.WriteLine(dstTree);  

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

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot")  

dstTree.Add( _  
    From el In srcTree.Elements() _  
    Where el.Value <= 1 _  
    Select <Child><%= el.Value %></Child> _  
)  

dstTree.Add( _  
    From el In srcTree.Elements() _  
    Where el.Value >= 3 _  
    Select <DifferentChild><%= el.Value %></DifferentChild> _  
)  

Console.WriteLine(dstTree)  

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

<NewRoot>  
  <Child>1</Child>  
  <DifferentChild>3</DifferentChild>  
  <DifferentChild>4</DifferentChild>  
  <DifferentChild>5</DifferentChild>  
</NewRoot>  

備註

這個建構函式會將指定的內容和屬性新增至 XStreamingElement 。 雖然通常可以在單一語句中建構 XStreamingElement ，但有時候以累加方式將內容新增至串流專案會更方便。

在序列化 之前 XStreamingElement ，不會逐一查看查詢。 這與針對 的內容使用查詢 XElement 相反，其中查詢會在建構新 XElement 時逐一查看。

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

另請參閱

• LINQ to XML 概觀

Add(Object[])

將指定的內容當做子系加入至這個 XStreamingElement。

public:
 void Add(... cli::array <System::Object ^> ^ content);

public void Add (params object[] content);

public void Add (params object?[] content);

member this.Add : obj[] -> unit

Public Sub Add (ParamArray content As Object())

參數

content

Object[]

要加入到資料流項目的內容。

範例

下列範例會建立新的 XStreamingElement 。 然後，它會將兩個查詢新增至串流專案。 在序列化串流專案之前，查詢不會逐一查看。

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

XStreamingElement dstTree = new XStreamingElement("NewRoot");  

dstTree.Add(  
    from el in srcTree.Elements()  
    where (int)el <= 1  
    select new XElement("Child", (int)el)  
);  

dstTree.Add(  
    from el in srcTree.Elements()  
    where (int)el >= 3  
    select new XElement("DifferentChild", (int)el)  
);  

Console.WriteLine(dstTree);  

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

Dim dstTree As XStreamingElement = New XStreamingElement("NewRoot")  

dstTree.Add( _  
    From el In srcTree.Elements() _  
    Where el.Value <= 1 _  
    Select <Child><%= el.Value %></Child> _  
)  

dstTree.Add( _  
    From el In srcTree.Elements() _  
    Where el.Value >= 3 _  
    Select <DifferentChild><%= el.Value %></DifferentChild> _  
)  

Console.WriteLine(dstTree)  

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

<NewRoot>  
  <Child>1</Child>  
  <DifferentChild>3</DifferentChild>  
  <DifferentChild>4</DifferentChild>  
  <DifferentChild>5</DifferentChild>  
</NewRoot>  

備註

這個建構函式會將指定的內容和屬性新增至 XStreamingElement 。 雖然通常可以在單一語句中建構 XStreamingElement ，但有時候以累加方式將內容新增至串流專案會更方便。

在序列化 之前 XStreamingElement ，不會逐一查看查詢。 這與針對 的內容使用查詢 XElement 相反，其中查詢會在建構新 XElement 時逐一查看。

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

另請參閱

• LINQ to XML 概觀