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

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

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

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

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

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

パラメーター

例外

例

次の例では、属性を持つ要素を作成します。 次に、このメソッドを使用して属性の内容を置き換えます。

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

// Add some name/value pairs.
root.SetAttributeValue("Att1", 1);
root.SetAttributeValue("Att2", 2);
root.SetAttributeValue("Att3", 3);
Console.WriteLine(root);

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

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

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

' Add some name/value pairs.
root.SetAttributeValue("Att1", 1)
root.SetAttributeValue("Att2", 2)
root.SetAttributeValue("Att3", 3)
Console.WriteLine(root)

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

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

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

<Root Att1="1" Att2="2" Att3="3" />
<Root Att1="1" Att2="22" Att3="3" />
<Root Att1="1" Att2="22" />

注釈

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

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

値は、指定した名前の属性に割り当てられます。 指定した名前の属性が存在しない場合は、新しい属性が追加されます。 値が null場合は、指定した名前の属性 (存在する場合) が削除されます。

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

こちらもご覧ください

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