XElement.SetAttributeValue(XName, Object) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Xml.Linq
Bütünleştirilmiş Kod:
System.Xml.XDocument.dll
Bütünleştirilmiş Kod:
System.Xml.Linq.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
XElement.cs
Kaynak:
XElement.cs
Kaynak:
XElement.cs

Özniteliğin değerini ayarlar, öznitelik ekler veya özniteliği kaldırır.

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)

Parametreler

name
XName

XName Değiştirecek özniteliğin adını içeren bir.

value
Object

Özniteliğe atanacak değer. değeri nullise özniteliği kaldırılır. Aksi takdirde, değer dize gösterimine dönüştürülür ve özniteliğinin Value özelliğine atanır.

Özel durumlar

ArgumentException

value bir örneğidirXObject.

Örnekler

Aşağıdaki örnek, özniteliği olan bir öğe oluşturur. Daha sonra özniteliğinin içeriğini değiştirmek için bu yöntemi kullanır.

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

Bu örnek aşağıdaki çıkışı oluşturur:

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

Açıklamalar

Bu yöntem, bir dizi öznitelik olarak ad/değer çiftlerinin listesini korumayı kolaylaştırmak için tasarlanmıştır. Listeyi korurken çift eklemeniz, çiftleri değiştirmeniz veya silmeniz gerekir. Öznitelik olarak var olmayan bir ad geçirerek bu yöntemi çağırırsanız, bu yöntem sizin için bir öznitelik oluşturur. Varolan bir özniteliğin adını geçirerek bu yöntemi çağırırsanız, bu yöntem özniteliğin değerini belirttiğiniz değerle değiştirir. için valuegeçirirseniznull, bu yöntem özniteliğini kaldırır.

Bu yöntem ve olaylarını ChangedChanging oluşturur.

Değer, belirtilen ada sahip özniteliğine atanır. Belirtilen ada sahip öznitelik yoksa, yeni bir öznitelik eklenir. değer ise null, belirtilen ada (varsa) sahip öznitelik silinir.

Daha fazla bilgi için bkz . Ad-değer çiftlerini koruma.

Şunlara uygulanır

Ayrıca bkz.