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

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

public void SetElementValue (System.Xml.Linq.XName name, 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)

パラメーター

例外

例

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

// 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 の概要
• 名前と値のペアを保持する