Bagikan melalui


Properti Sumbu Atribut XML (Visual Basic)

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

Lihat juga