XElement.SetElementValue(XName, Object) XElement.SetElementValue(XName, Object) XElement.SetElementValue(XName, Object) XElement.SetElementValue(XName, Object) Method

定義

子要素の値の設定、子要素の追加、または子要素の削除を行います。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 XName XName XName

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

value
Object Object Object 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. 渡した場合nullvalue、このメソッドは、子要素を削除します。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. 派生した任意のオブジェクトの場合、このメソッドが例外をスローXObjectとして渡される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.

適用対象

こちらもご覧ください