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

注釈

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

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

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

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

適用対象

こちらもご覧ください

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