Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Menyediakan akses ke nilai atribut untuk XElement objek atau ke elemen pertama dalam kumpulan XElement objek.
Sintaksis
object.@attribute
' -or-
object.@<attribute>
Bagian
object Diperlukan. Objek XElement atau kumpulan XElement objek.
.@ Diperlukan. Menunjukkan awal properti sumbu atribut.
< Opsional. Menunjukkan awal nama atribut ketika attribute bukan pengidentifikasi yang valid di Visual Basic.
attribute Diperlukan. Nama atribut yang akan diakses, dari formulir [prefix:]name.
| Bagian | Deskripsi |
|---|---|
prefix |
Fakultatif. Awalan namespace XML untuk atribut . Harus berupa namespace XML global yang Imports ditentukan dengan pernyataan. |
name |
Dibutuhkan. Nama atribut lokal. Lihat Nama Elemen dan Atribut XML yang Dideklarasikan. |
> Opsional. Menunjukkan akhir nama atribut ketika attribute bukan pengidentifikasi yang valid di Visual Basic.
Mengembalikan Nilai
String yang berisi nilai attribute. Jika nama atribut tidak ada, Nothing dikembalikan.
Komentar
Anda dapat menggunakan properti sumbu atribut XML untuk mengakses nilai atribut berdasarkan nama dari XElement objek atau dari elemen pertama dalam kumpulan XElement objek. Anda dapat mengambil nilai atribut berdasarkan nama, atau menambahkan atribut baru ke elemen dengan menentukan nama baru yang didahului oleh pengidentifikasi @.
Saat Anda merujuk ke atribut XML menggunakan pengidentifikasi @, nilai atribut dikembalikan sebagai string dan Anda tidak perlu menentukan Value properti secara eksplisit.
Aturan penamaan untuk atribut XML berbeda dari aturan penamaan untuk pengidentifikasi Visual Basic. Untuk mengakses atribut XML yang memiliki nama yang bukan pengidentifikasi Visual Basic yang valid, sertakan nama dalam tanda kurung sudut (< dan >).
Ruang Nama XML
Nama dalam properti sumbu atribut hanya dapat menggunakan awalan namespace XML yang dideklarasikan secara global dengan menggunakan Imports pernyataan . Ini tidak dapat menggunakan awalan namespace XML yang dideklarasikan secara lokal dalam literal elemen XML. Untuk informasi selengkapnya, lihat Pernyataan Impor (Namespace XML).
Contoh 1
Contoh berikut menunjukkan cara mendapatkan nilai atribut XML bernama type dari kumpulan elemen XML yang diberi nama phone.
' Topic: XML Attribute Axis Property
Dim phones As XElement =
<phones>
<phone type="home">206-555-0144</phone>
<phone type="work">425-555-0145</phone>
</phones>
Dim phoneTypes As XElement =
<phoneTypes>
<%= From phone In phones.<phone>
Select <type><%= phone.@type %></type>
%>
</phoneTypes>
Console.WriteLine(phoneTypes)
Kode ini menampilkan teks berikut:
<phoneTypes>
<type>home</type>
<type>work</type>
</phoneTypes>
Contoh 2
Contoh berikut menunjukkan cara membuat atribut untuk elemen XML baik secara deklaratif, sebagai bagian dari XML, dan secara dinamis dengan menambahkan atribut ke instans XElement objek. Atribut type dibuat secara deklaratif dan owner atribut dibuat secara dinamis.
Dim phone2 As XElement = <phone type="home">206-555-0144</phone>
phone2.@owner = "Harris, Phyllis"
Console.WriteLine(phone2)
Kode ini menampilkan teks berikut:
<phone type="home" owner="Harris, Phyllis">206-555-0144</phone>
Contoh 3
Contoh berikut menggunakan sintaks kurung sudut untuk mendapatkan nilai atribut XML bernama number-type, yang bukan pengidentifikasi yang valid di Visual Basic.
Dim phone As XElement =
<phone number-type=" work">425-555-0145</phone>
Console.WriteLine("Phone type: " & phone.@<number-type>)
Kode ini menampilkan teks berikut:
Phone type: work
Contoh 4
Contoh berikut mendeklarasikan ns sebagai awalan namespace XML. Kemudian menggunakan awalan namespace layanan untuk membuat XML literal dan mengakses simpul anak pertama dengan nama yang memenuhi syarat "ns:name".
Imports <xmlns:ns = "http://SomeNamespace">
Class TestClass3
Shared Sub TestPrefix()
Dim phone =
<ns:phone ns:type="home">206-555-0144</ns:phone>
Console.WriteLine("Phone type: " & phone.@ns:type)
End Sub
End Class
Kode ini menampilkan teks berikut:
Phone type: home