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

定義

属性の値の設定、属性の追加、または属性の削除を行います。Sets the value of an attribute, adds an attribute, or removes an attribute.

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

変更する属性の名前を格納する XNameAn XName that contains the name of the attribute to change.

value
Object

属性に代入する値。The value to assign to the attribute. 値が null の場合は属性が削除されます。The attribute 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 attribute.

例外

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

次の例では、属性を持つ要素を作成します。The following example creates an element with an attribute. 次に、このメソッドを使用して、属性の内容を置き換えます。It then uses this method to replace the content of the attribute.

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

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

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

注釈

このメソッドは、名前と値のペアのリストを一連の属性として簡単に維持できるように設計されています。This method is designed to make it easy to maintain a list of name/value pairs as a set of attributes. リストを維持する場合は、ペアの追加、ペアの変更、またはペアの削除を行う必要があります。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 an attribute, this method creates an attribute for you. このメソッドを呼び出して既存の属性の名前を渡すと、このメソッドは属性の値を、指定した値に変更します。If you call this method passing the name of an existing attribute, this method modifies the value of the attribute to the value that you specify. @No__t-1 に null を渡した場合、このメソッドは属性を削除します。If you pass null for value, this method removes the attribute.

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

値は、指定された名前の属性に割り当てられます。The value is assigned to the attribute with the specified name. 指定した名前の属性が存在しない場合は、新しい属性が追加されます。If no attribute with the specified name exists, a new attribute is added. 値が @no__t 0 の場合は、指定した名前の属性 (存在する場合) が削除されます。If the value is null, the attribute with the specified name, if any, is deleted.

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

適用対象

こちらもご覧ください