XContainer.AddFirst メソッド

リファレンス

定義

名前空間:: System.Xml.Linq

アセンブリ:: System.Xml.XDocument.dll

アセンブリ:: System.Xml.Linq.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定した内容をこのドキュメントまたは要素の最初の子として追加します。

オーバーロード

AddFirst(Object)	指定した内容をこのドキュメントまたは要素の最初の子として追加します。
AddFirst(Object[])	指定した内容をこのドキュメントまたは要素の最初の子として追加します。

例

次の例では、2 つの XML ツリーを作成し、このメソッドを使用していずれかのクエリの結果を追加します。

XElement srcTree = new XElement("Root",  
    new XElement("Element1", 1),  
    new XElement("Element2", 2),  
    new XElement("Element3", 3),  
    new XElement("Element4", 4),  
    new XElement("Element5", 5)  
);  
XElement xmlTree = new XElement("Root",  
    new XElement("NewElement", "Content")  
);  
xmlTree.AddFirst(  
    from el in srcTree.Elements()  
    where (int)el >= 3  
    select el  
);  
Console.WriteLine(xmlTree);

Dim srcTree As XElement = _   
        <Root>  
            <Element1>1</Element1>  
            <Element2>2</Element2>  
            <Element3>3</Element3>  
            <Element4>4</Element4>  
            <Element5>5</Element5>  
        </Root>  
Dim xmlTree As XElement = <Root>  
                              <NewElement>Content</NewElement>  
                          </Root>  
xmlTree.AddFirst( _  
    From el In srcTree.Elements _  
    Where CInt(el) >= 3 _  
    Select el)  
Console.WriteLine(xmlTree)

この例を実行すると、次の出力が生成されます。

<Root>  
  <Element3>3</Element3>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
  <NewElement>Content</NewElement>  
</Root>

注釈

このメソッドは、の既存のコンテンツの前に新しいコンテンツを追加します XContainer。

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

このメソッドは、イベントとイベントをChanging発生させますChanged。

AddFirst(Object)

Source:: XContainer.cs

Source:: XContainer.cs

Source:: XContainer.cs

指定した内容をこのドキュメントまたは要素の最初の子として追加します。

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

public void AddFirst (object content);

public void AddFirst (object? content);

member this.AddFirst : obj -> unit

Public Sub AddFirst (content As Object)

パラメーター

content: Object

追加する単純な内容またはコンテンツオブジェクトのコレクションを格納しているコンテンツオブジェクト。

例

次の例では、2 つの XML ツリーを作成します。このメソッドを使用して、オブジェクトを XElement 最初の要素としていずれかの要素に追加します。また、LINQ クエリの結果を XML ツリーに追加します。

XElement srcTree = new XElement("Root",  
    new XElement("Element1", 1),  
    new XElement("Element2", 2),  
    new XElement("Element3", 3),  
    new XElement("Element4", 4),  
    new XElement("Element5", 5)  
);  
XElement xmlTree = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5)  
);  
xmlTree.AddFirst(new XElement("NewChild", "new content"));  
xmlTree.AddFirst(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
// Even though Child9 does not exist in srcTree, the following statement will not  
// throw an exception, and nothing will be added to xmlTree  
xmlTree.AddFirst(srcTree.Element("Child9"));  
Console.WriteLine(xmlTree);

Dim srcTree As XElement = _   
        <Root>  
            <Element1>1</Element1>  
            <Element2>2</Element2>  
            <Element3>3</Element3>  
            <Element4>4</Element4>  
            <Element5>5</Element5>  
        </Root>  

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

xmlTree.AddFirst(New XElement("NewChild", "new content"))  
xmlTree.AddFirst( _  
    From el In srcTree.Elements() _  
    Where CInt(el) > 3 _  
    Select el _  
)  
' Even though Child9 does not exist in srcTree, the following statement will not  
' throw an exception, and nothing will be added to xmlTree  
xmlTree.AddFirst(srcTree.<Child9>)  
Console.WriteLine(xmlTree)

この例を実行すると、次の出力が生成されます。

<Root>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
  <NewChild>new content</NewChild>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>

注釈

このメソッドは、の既存のコンテンツの前に新しいコンテンツを追加します XContainer。

このメソッドは、イベントとイベントをChanging発生させますChanged。

こちらもご覧ください

適用対象

AddFirst(Object[])

Source:: XContainer.cs

Source:: XContainer.cs

Source:: XContainer.cs

指定した内容をこのドキュメントまたは要素の最初の子として追加します。

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

public void AddFirst (params object[] content);

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

member this.AddFirst : obj[] -> unit

Public Sub AddFirst (ParamArray content As Object())

パラメーター

content: Object[]

コンテンツオブジェクトのパラメーターリスト。

例外

InvalidOperationException

親は null になります。

例

次の例では、2 つの XML ツリーを作成し、このメソッドを使用してオブジェクトを XElement 最初の要素としていずれかの要素に追加します。また、LINQ クエリの結果を XML ツリーに追加します。

XElement srcTree = new XElement("Root",  
    new XElement("Element1", 1),  
    new XElement("Element2", 2),  
    new XElement("Element3", 3),  
    new XElement("Element4", 4),  
    new XElement("Element5", 5)  
);  
XElement xmlTree = new XElement("Root",  
    new XElement("Child1", 1),  
    new XElement("Child2", 2),  
    new XElement("Child3", 3),  
    new XElement("Child4", 4),  
    new XElement("Child5", 5)  
);  
xmlTree.AddFirst(new XElement("NewChild", "new content"));  
xmlTree.AddFirst(  
    from el in srcTree.Elements()  
    where (int)el > 3  
    select el  
);  
// Even though Child9 does not exist in srcTree, the following statement will not  
// throw an exception, and nothing will be added to xmlTree.  
xmlTree.AddFirst(srcTree.Element("Child9"));  
Console.WriteLine(xmlTree);

Dim srcTree As XElement = _   
        <Root>  
            <Element1>1</Element1>  
            <Element2>2</Element2>  
            <Element3>3</Element3>  
            <Element4>4</Element4>  
            <Element5>5</Element5>  
        </Root>  

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

xmlTree.AddFirst(New XElement("NewChild", "new content"))  
xmlTree.AddFirst( _  
    From el In srcTree.Elements() _  
    Where CInt(el) > 3 _  
    Select el _  
)  
' Even though Child9 does not exist in srcTree, the following statement will not  
' throw an exception, and nothing will be added to xmlTree.  
xmlTree.AddFirst(srcTree.<Child9>)  
Console.WriteLine(xmlTree)

この例を実行すると、次の出力が生成されます。

<Root>  
  <Element4>4</Element4>  
  <Element5>5</Element5>  
  <NewChild>new content</NewChild>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>

注釈

このメソッドは、の既存のコンテンツの前に新しいコンテンツを追加します XContainer。

このメソッドは、イベントとイベントをChanging発生させますChanged。

こちらもご覧ください

適用対象

XContainer.AddFirst メソッド

定義

オーバーロード

例

注釈

AddFirst(Object)

パラメーター

例

注釈

こちらもご覧ください

適用対象

AddFirst(Object[])

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

フィードバック

その他のリソース