XNode.ReplaceWith メソッド

定義

名前空間:

System.Xml.Linq

アセンブリ:

System.Xml.Linq.dll

このノードを指定したコンテンツに置き換えます。

オーバーロード

名前	説明
ReplaceWith(Object)	このノードを指定したコンテンツに置き換えます。
ReplaceWith(Object[])	このノードを指定したコンテンツに置き換えます。

例

次の例では、このメソッドを使用して、ノードの内容を別のコンテンツに置き換えます。

XElement xmlTree = new XElement("Root",
    new XElement("Child1", "child1 content"),
    new XElement("Child2", "child2 content"),
    new XElement("Child3", "child3 content"),
    new XElement("Child4", "child4 content"),
    new XElement("Child5", "child5 content")
);
XElement child3 = xmlTree.Element("Child3");
child3.ReplaceWith(
    new XElement("NewChild", "new content")
);
Console.WriteLine(xmlTree);

Dim xmlTree As XElement = _
        <Root>
            <Child1>child1 content</Child1>
            <Child2>child2 content</Child2>
            <Child3>child3 content</Child3>
            <Child4>child4 content</Child4>
            <Child5>child5 content</Child5>
        </Root>

Dim child3 As XElement = xmlTree.<Child3>(0)
child3.ReplaceWith(<NewChild>new content</NewChild>)
Console.WriteLine(xmlTree)

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

<Root>
  <Child1>child1 content</Child1>
  <Child2>child2 content</Child2>
  <NewChild>new content</NewChild>
  <Child4>child4 content</Child4>
  <Child5>child5 content</Child5>
</Root>

注釈

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

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

XContainerは、その子ノードを、XNode オブジェクトの 1 つのリンクされたリストとして格納します。 つまり、 ReplaceWith メソッドは、親コンテナーの下にある直接の子ノードの一覧を走査する必要があります。 そのため、この方法を使用すると、パフォーマンスに影響する可能性があります。

ReplaceWith(Object)

このノードを指定したコンテンツに置き換えます。

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

public void ReplaceWith(object content);

member this.ReplaceWith : obj -> unit

Public Sub ReplaceWith (content As Object)

パラメーター

content

Object

このノードを置き換えるコンテンツ。

例

次の例では、このメソッドを使用して、ノードの内容を別のコンテンツに置き換えます。

XElement xmlTree = new XElement("Root",
    new XElement("Child1", "child1 content"),
    new XElement("Child2", "child2 content"),
    new XElement("Child3", "child3 content"),
    new XElement("Child4", "child4 content"),
    new XElement("Child5", "child5 content")
);
XElement child3 = xmlTree.Element("Child3");
child3.ReplaceWith(
    new XElement("NewChild", "new content")
);
Console.WriteLine(xmlTree);

Dim xmlTree As XElement = _
        <Root>
            <Child1>child1 content</Child1>
            <Child2>child2 content</Child2>
            <Child3>child3 content</Child3>
            <Child4>child4 content</Child4>
            <Child5>child5 content</Child5>
        </Root>

Dim child3 As XElement = xmlTree.<Child3>(0)
child3.ReplaceWith(<NewChild>new content</NewChild>)
Console.WriteLine(xmlTree)

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

<Root>
  <Child1>child1 content</Child1>
  <Child2>child2 content</Child2>
  <NewChild>new content</NewChild>
  <Child4>child4 content</Child4>
  <Child5>child5 content</Child5>
</Root>

注釈

このメソッドは、最初にこのノードを親から削除してから、指定したコンテンツをこのノードの親ノードの代わりに追加します。

XContainerは、その子ノードを、XNode オブジェクトの 1 つのリンクされたリストとして格納します。 つまり、 ReplaceWith メソッドは、親コンテナーの下にある直接の子ノードの一覧を走査する必要があります。 そのため、この方法を使用すると、パフォーマンスに影響する可能性があります。

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

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

こちらもご覧ください

• LINQ to XML の概要

ReplaceWith(Object[])

このノードを指定したコンテンツに置き換えます。

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

public void ReplaceWith(params object[] content);

member this.ReplaceWith : obj[] -> unit

Public Sub ReplaceWith (ParamArray content As Object())

パラメーター

content

Object[]

新しいコンテンツのパラメーター リスト。

例

次の例は、LINQ to 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)
);
XElement child3 = xmlTree.Element("Child3");
child3.ReplaceWith(
    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 child3 As XElement = xmlTree.<Child3>(0)
child3.ReplaceWith( _
    From el In srcTree.Elements() _
    Where (CInt(el) > 3) _
    Select el)

Console.WriteLine(xmlTree)

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

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

注釈

このメソッドは、最初にこのノードを親から削除してから、指定したコンテンツをこのノードの親ノードの代わりに追加します。

XContainerは、その子ノードを、XNode オブジェクトの 1 つのリンクされたリストとして格納します。 つまり、 ReplaceWith メソッドは、親コンテナーの下にある直接の子ノードの一覧を走査する必要があります。 そのため、この方法を使用すると、パフォーマンスに影響する可能性があります。

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

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

こちらもご覧ください

• LINQ to XML の概要