XNode.AddBeforeSelf メソッド

定義

指定した内容をこのノードの直前に追加します。Adds the specified content immediately before this node.

オーバーロード

AddBeforeSelf(Object)

指定した内容をこのノードの直前に追加します。Adds the specified content immediately before this node.

AddBeforeSelf(Object[])

指定した内容をこのノードの直前に追加します。Adds the specified content immediately before this node.

IEnumerable<T>の例では、LINQ クエリを使用しXElementてのを作成し、その後このメソッドに渡します。The following example uses a LINQ query to create an IEnumerable<T> of XElement, which it then passes to this method. これにより、クエリの結果がツリーの目的の場所に追加されます。This adds the results of a query to the tree in the desired location.

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)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    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>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
        </Root>  
  
Dim child1 As XElement = xmlTree.<Child1>(0)  
child1.AddBeforeSelf( _  
From el In srcTree.Elements() _  
Where CInt(el) > 3 _  
Select el)  
  
Console.WriteLine(xmlTree)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

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

注釈

このメソッドに渡すことができる有効なコンテンツの詳細については、「 XElement オブジェクトと XDocument オブジェクトの有効なコンテンツ」を参照してください。For details about the valid content that can be passed to this method, see Valid Content of XElement and XDocument Objects.

このメソッドは、 ChangedイベントとChangingイベントを発生させます。This method will raise the Changed and Changing events.

XContainer 、子メモをオブジェクトのXNodeシングルリンクリストとして格納します。The XContainer stores its child notes as a singly-linked list of XNode objects. これは、 AddBeforeSelfメソッドが親コンテナーの下にある直接の子ノードのリストを走査する必要があることを意味します。This means that the AddBeforeSelf method must traverse the list of direct child nodes under the parent container. したがって、この方法を使用すると、パフォーマンスに影響を与える可能性があります。Therefore, using this method might affect your performance.

AddBeforeSelf(Object)

指定した内容をこのノードの直前に追加します。Adds the specified content immediately before this node.

public:
 void AddBeforeSelf(System::Object ^ content);
public void AddBeforeSelf (object content);
member this.AddBeforeSelf : obj -> unit
Public Sub AddBeforeSelf (content As Object)

パラメーター

content
Object

このノードの前に追加する単純な内容またはコンテンツ オブジェクトのコレクションを格納しているコンテンツ オブジェクト。A content object that contains simple content or a collection of content objects to be added before this node.

例外

親は null になります。The parent is null.

次の例では、このメソッドを使用して、ツリーに要素を追加します。The following example uses this method to add an element into the tree.

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)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    new XElement("NewChild", 10)  
);  
Console.WriteLine(xmlTree);  
Dim xmlTree As XElement = _   
        <Root>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
        </Root>  
  
Dim child1 As XElement = xmlTree.<Child1>(0)  
child1.AddBeforeSelf(New XElement("NewChild", 10))  
Console.WriteLine(xmlTree)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

<Root>  
  <NewChild>10</NewChild>  
  <Child1>1</Child1>  
  <Child2>2</Child2>  
  <Child3>3</Child3>  
  <Child4>4</Child4>  
  <Child5>5</Child5>  
</Root>  

注釈

このメソッドに渡すことができる有効なコンテンツの詳細については、「 XElement オブジェクトと XDocument オブジェクトの有効なコンテンツ」を参照してください。For details about the valid content that can be passed to this method, see Valid Content of XElement and XDocument Objects.

このメソッドは、 Changed Changingイベントとイベントを発生させます。This method will raise the Changed and the Changing events.

XContainer 、その子ノードをオブジェクトのXNodeシングルリンクリストとして格納します。The XContainer stores its child nodes as a singly-linked list of XNode objects. これは、 AddBeforeSelfメソッドが親コンテナーの下にある直接の子ノードのリストを走査する必要があることを意味します。This means that the AddBeforeSelf method must traverse the list of direct child nodes under the parent container. したがって、この方法を使用すると、パフォーマンスに影響を与える可能性があります。Therefore, using this method might affect your performance.

こちらもご覧ください

AddBeforeSelf(Object[])

指定した内容をこのノードの直前に追加します。Adds the specified content immediately before this node.

public:
 void AddBeforeSelf(... cli::array <System::Object ^> ^ content);
public void AddBeforeSelf (params object[] content);
member this.AddBeforeSelf : obj[] -> unit
Public Sub AddBeforeSelf (ParamArray content As Object())

パラメーター

content
Object[]

コンテンツ オブジェクトのパラメーター リスト。A parameter list of content objects.

例外

親は null になります。The parent is null.

IEnumerable<T>の例では、LINQ クエリを使用しXElementてのを作成し、その後このメソッドに渡します。The following example uses a LINQ query to create an IEnumerable<T> of XElement, which it then passes to this method. これにより、クエリの結果がツリーの目的の場所に追加されます。This adds the results of a query to the tree in the desired location.

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)  
);  
XElement child1 = xmlTree.Element("Child1");  
child1.AddBeforeSelf(  
    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>  
            <Child1>1</Child1>  
            <Child2>2</Child2>  
            <Child3>3</Child3>  
            <Child4>4</Child4>  
            <Child5>5</Child5>  
        </Root>  
  
Dim child1 As XElement = xmlTree.<Child1>(0)  
child1.AddBeforeSelf( _  
    From el In srcTree.Elements() _  
    Where CInt(el) > 3 _  
    Select el)  
  
Console.WriteLine(xmlTree)  

この例を実行すると、次の出力が生成されます。This example produces the following output:

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

注釈

このメソッドに渡すことができる有効なコンテンツの詳細については、「 XElement オブジェクトと XDocument オブジェクトの有効なコンテンツ」を参照してください。For details about the valid content that can be passed to this method, see Valid Content of XElement and XDocument Objects.

このメソッドは、 Changed Changingイベントとイベントを発生させます。This method will raise the Changed and the Changing events.

XContainer 、その子ノードをオブジェクトのXNodeシングルリンクリストとして格納します。The XContainer stores its child nodes as a singly-linked list of XNode objects. これは、 AddBeforeSelfメソッドが親コンテナーの下にある直接の子ノードのリストを走査する必要があることを意味します。This means that the AddBeforeSelf method must traverse the list of direct child nodes under the parent container. このため、この関数を使用すると、パフォーマンスに影響を与える可能性があります。Therefore, using this function might affect your performance.

こちらもご覧ください

適用対象