XElement.SetElementValue(XName, Object) メソッド

定義

名前空間:

System.Xml.Linq

アセンブリ:

System.Xml.XDocument.dll

Source:

XElement.cs

子要素の値の設定、子要素の追加、または子要素の削除を行います。

public:
 void SetElementValue(System::Xml::Linq::XName ^ name, System::Object ^ value);

public void SetElementValue (System.Xml.Linq.XName name, object? value);

member this.SetElementValue : System.Xml.Linq.XName * obj -> unit

Public Sub SetElementValue (name As XName, value As Object)

パラメーター

name

XName

変更する子要素の名前を格納する XName。

value

Object

子要素に代入する値。 値が null の場合は、子要素が削除されます。 それ以外の場合は、値が文字列形式に変換され、子要素の Value プロパティに代入されます。

例外

ArgumentException

value が、XObject のインスタンスです。

例

次の例では、子要素を持つ 要素を作成します。 次に、このメソッドを使用して子要素の値を設定します。

// Create an element with no content
XElement root = new XElement("Root");

// Add some name/value pairs.
root.SetElementValue("Ele1", 1);
root.SetElementValue("Ele2", 2);
root.SetElementValue("Ele3", 3);
Console.WriteLine(root);

// Modify one of the name/value pairs.
root.SetElementValue("Ele2", 22);
Console.WriteLine(root);

// Remove one of the name/value pairs.
root.SetElementValue("Ele3", null);
Console.WriteLine(root);

' Create an element with no content.
Dim root As XElement = <Root/>

' Add some name/value pairs.
root.SetElementValue("Ele1", 1)
root.SetElementValue("Ele2", 2)
root.SetElementValue("Ele3", 3)
Console.WriteLine(root)

' Modify one of the name/value pairs.
root.SetElementValue("Ele2", 22)
Console.WriteLine(root)

' Remove one of the name/value pairs.
root.SetElementValue("Ele3", Nothing)
Console.WriteLine(root)

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

<Root>
  <Ele1>1</Ele1>
  <Ele2>2</Ele2>
  <Ele3>3</Ele3>
</Root>
<Root>
  <Ele1>1</Ele1>
  <Ele2>22</Ele2>
  <Ele3>3</Ele3>
</Root>
<Root>
  <Ele1>1</Ele1>
  <Ele2>22</Ele2>
</Root>

注釈

このメソッドは、名前と値のペアのリストを子要素のセットとして簡単に維持できるように設計されています。 リストを維持する場合は、ペアの追加、ペアの変更、またはペアの削除が必要です。 子要素として存在しない名前を渡してこのメソッドを呼び出すと、このメソッドによって子要素が自動的に作成されます。 このメソッドを呼び出して既存の子要素の名前を渡すと、このメソッドは子要素の値を指定した値に変更します。 に をvalue渡nullすと、このメソッドは子要素を削除します。

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

値は、指定した名前の最初の子要素に割り当てられます。 指定した名前の子要素が存在しない場合は、新しい子要素が追加されます。 値が null の場合は、指定した名前を持つ最初の子要素 (存在する場合) が削除されます。

このメソッドは、指定した子要素に子ノードまたは属性を追加しません。 から派生 XObject したオブジェクトが として value渡された場合、このメソッドは例外をスローします。

詳細については、「 名前と値のペアを維持する」を参照してください。

こちらもご覧ください

• SetValue(Object)
• SetElementValue(XName, Object)
• SetValue(Object)
• LINQ to XML の概要
• 名前と値のペアを保持する