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

定義

子要素の値の設定、子要素の追加、または子要素の削除を行います。Sets the value of a child element, adds a child element, or removes a child element.

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

変更する子要素の名前を格納する XNameAn XName that contains the name of the child element to change.

value
Object

子要素に代入する値。The value to assign to the child element. 値が null の場合は、子要素が削除されます。The child element is removed if the value is null. それ以外の場合は、値が文字列形式に変換され、子要素の Value プロパティに代入されます。Otherwise, the value is converted to its string representation and assigned to the Value property of the child element.

例外

value が、XObject のインスタンスです。The value is an instance of XObject.

次の例では、子要素を持つ要素を作成します。The following example creates an element with a child element. 次に、このメソッドを使用して、子要素の値を設定します。It then uses this method to set the value of the child element.

// 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)  

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

<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>  

注釈

このメソッドは、一連の子要素として名前/値ペアのリストを簡単に維持できるように設計されています。This method is designed to make it easy to maintain a list of name/value pairs as a set of children elements. リストを維持する場合は、ペアの追加、ペアの変更、またはペアの削除を行う必要があります。When maintaining the list, you need to add pairs, modify pairs, or delete pairs. このメソッドを呼び出して、子要素として存在しない名前を渡すと、子要素が作成されます。If you call this method passing a name that does not exist as a child element, this method creates a child element for you. このメソッドを呼び出して既存の子要素の名前を渡すと、このメソッドによって、子要素の値が、指定した値に変更されます。If you call this method passing the name of an existing child element, this method modifies the value of the child element to the value that you specify. @No__t-1 に null を渡した場合、このメソッドは子要素を削除します。If you pass null for value, this method removes the child element.

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

値は、指定された名前を持つ最初の子要素に割り当てられます。The value is assigned to the first child element with the specified name. 指定した名前の子要素が存在しない場合は、新しい子要素が追加されます。If no child element with the specified name exists, a new child element is added. 値が null の場合は、指定された名前を持つ最初の子要素 (存在する場合) が削除されます。If the value is null, the first child element with the specified name, if any, is deleted.

このメソッドは、指定された子要素に子ノードまたは属性を追加しません。This method does not add child nodes or attributes to the specified child element. @No__t-0 から派生したオブジェクトが value として渡された場合、このメソッドは例外をスローします。This method throws an exception if any object that derives from XObject is passed as value.

詳細については、「名前と値のペアの保守」を参照してください。For more information, see Maintaining Name/Value Pairs.

適用対象

こちらもご覧ください