XStreamingElement.Add メソッド

定義

名前空間:

System.Xml.Linq

アセンブリ:

System.Xml.XDocument.dll

指定した内容をこの XStreamingElement に子として追加します。

オーバーロード

Add(Object)	指定した内容をこの XStreamingElement に子として追加します。
Add(Object[])	指定した内容をこの XStreamingElement に子として追加します。

Add(Object)

ソース:

XStreamingElement.cs

指定した内容をこの XStreamingElement に子として追加します。

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

public void Add (object? content);

member this.Add : obj -> unit

Public Sub Add (content As Object)

パラメーター

content

Object

ストリーム要素に追加されるコンテンツ。

例

次の例では、新 XStreamingElementしい を作成します。 次に、ストリーミング要素に 2 つのクエリを追加します。 ストリーミング要素がシリアル化されるまで、クエリは反復処理されません。

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追加します。 多くの場合、1 つのステートメントで を XStreamingElement 構築することは可能ですが、ストリーミング要素にコンテンツを段階的に追加する方が便利な場合があります。

クエリは、 がシリアル化されるまで XStreamingElement 反復処理されません。 これは、 のコンテンツ XElementに対してクエリを使用するのとは対照的で、新しい XElementの構築時にクエリが反復処理されます。

この関数に渡すことができる有効なコンテンツの詳細については、「 XElement オブジェクトと XDocument オブジェクトの有効なコンテンツ」を参照してください。

こちらもご覧ください

• LINQ to XML の概要

Add(Object[])

ソース:

XStreamingElement.cs

指定した内容をこの XStreamingElement に子として追加します。

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

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

member this.Add : obj[] -> unit

Public Sub Add (ParamArray content As Object())

パラメーター

content

Object[]

ストリーム要素に追加されるコンテンツ。

例

次の例では、新 XStreamingElementしい を作成します。 次に、ストリーミング要素に 2 つのクエリを追加します。 ストリーミング要素がシリアル化されるまで、クエリは反復処理されません。

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追加します。 多くの場合、1 つのステートメントで を XStreamingElement 構築することは可能ですが、ストリーミング要素にコンテンツを段階的に追加する方が便利な場合があります。

クエリは、 がシリアル化されるまで XStreamingElement 反復処理されません。 これは、 のコンテンツ XElementに対してクエリを使用するのとは対照的で、新しい XElementの構築時にクエリが反復処理されます。

この関数に渡すことができる有効なコンテンツの詳細については、「 XElement オブジェクトと XDocument オブジェクトの有効なコンテンツ」を参照してください。

こちらもご覧ください

• LINQ to XML の概要