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

定義

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

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

value
Object Object Object 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. 渡した場合nullvalue、このメソッドは、属性を削除します。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. 値が場合null、指定した名前を持つ属性がある場合は、削除します。If the value is null, the attribute with the specified name, if any, is deleted.

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

適用対象

こちらもご覧ください