XElement.SetAttributeValue(XName, Object) Metode

Referensi

Definisi

Ruang nama:: System.Xml.Linq

Rakitan:: System.Xml.XDocument.dll

Rakitan:: System.Xml.Linq.dll

Rakitan:: netstandard.dll

Sumber:: XElement.cs

Sumber:: XElement.cs

Sumber:: XElement.cs

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengatur nilai atribut, menambahkan atribut, atau menghapus atribut.

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)

Parameter

name: XName

Yang XName berisi nama atribut yang akan diubah.

value: Object

Nilai yang akan ditetapkan ke atribut . Atribut dihapus jika nilainya adalah null. Jika tidak, nilai dikonversi ke representasi stringnya dan ditetapkan ke Value properti atribut .

Pengecualian

ArgumentException

value adalah instans dari XObject.

Contoh

Contoh berikut membuat elemen dengan atribut . Kemudian menggunakan metode ini untuk mengganti konten atribut .

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

Contoh ini mencetak output berikut:

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

Keterangan

Metode ini dirancang untuk memudahkan untuk mempertahankan daftar pasangan nama/nilai sebagai sekumpulan atribut. Saat mempertahankan daftar, Anda perlu menambahkan pasangan, memodifikasi pasangan, atau menghapus pasangan. Jika Anda memanggil metode ini yang meneruskan nama yang tidak ada sebagai atribut, metode ini akan membuat atribut untuk Anda. Jika Anda memanggil metode ini meneruskan nama atribut yang ada, metode ini memodifikasi nilai atribut ke nilai yang Anda tentukan. Jika Anda meneruskan nullvalue, metode ini akan menghapus atribut .

Metode ini akan meningkatkan Changed peristiwa dan Changing .

Nilai ditetapkan ke atribut dengan nama yang ditentukan. Jika tidak ada atribut dengan nama yang ditentukan, atribut baru akan ditambahkan. Jika nilainya adalah null, atribut dengan nama yang ditentukan, jika ada, akan dihapus.

Untuk informasi selengkapnya, lihat Mempertahankan pasangan nama-nilai.

Berlaku untuk

Bagikan melalui