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

定義

名前空間:

System.Xml.Linq

アセンブリ:

System.Xml.XDocument.dll

ソース:

XElement.cs

属性の値の設定、属性の追加、または属性の削除を行います。

public:
 void SetAttributeValue(System::Xml::Linq::XName ^ name, System::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)

パラメーター

name

XName

変更する属性の名前を格納する XName。

value

Object

属性に代入する値。 値が null の場合は属性が削除されます。 それ以外の場合は、値が文字列形式に変換され、属性の Value プロパティに代入されます。

例外

ArgumentException

value が、XObject のインスタンスです。

例

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

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