Bagikan melalui


Properti Nilai XML (Visual Basic)

Menyediakan akses ke nilai elemen pertama dari koleksi objek XElement.

Sintaks

object.Value

Generator

Term Definisi
object Harus diisi. Koleksi objek XElement.

Tampilkan Nilai

String yang berisi nilai elemen pertama koleksi, atau Nothing jika koleksi kosong.

Keterangan

Properti Value memudahkan untuk mengakses nilai elemen pertama dalam kumpulan objek XElement. Properti ini pertama-tama memeriksa apakah koleksi berisi setidaknya satu objek. Jika koleksinya kosong, properti ini mengembalikan Nothing. Jika tidak, properti ini mengembalikan nilai properti Value dari elemen pertama dalam koleksi.

Catatan

Saat Anda mengakses nilai atribut XML menggunakan pengidentifikasi '@', nilai atribut dikembalikan sebagai String dan Anda tidak perlu menentukan properti Value secara eksplisit.

Untuk mengakses elemen lain dalam koleksi, Anda bisa menggunakan properti pengindeks ekstensi XML. Untuk informasi selengkapnya, lihat Properti Pengindeks Ekstensi.

Warisan

Sebagian besar pengguna tidak harus menerapkan IEnumerable<T>, dan karena itu dapat mengabaikan bagian ini.

Properti Value adalah properti ekstensi untuk jenis yang mengimplementasikan IEnumerable(Of XElement). Pengikatan properti ekstensi ini seperti pengikatan metode ekstensi: jika jenis mengimplementasikan salah satu antarmuka dan menentukan properti yang memiliki nama "Nilai", properti tersebut lebih diutamakan daripada properti ekstensi. Dengan kata lain, properti Value ini dapat ditimpa dengan mendefinisikan properti baru di kelas yang mengimplementasikan IEnumerable(Of XElement).

Contoh 1

Contoh berikut menunjukkan cara menggunakan properti Value untuk mengakses simpul pertama dalam kumpulan objek XElement. Contohnya menggunakan properti sumbu anak untuk mendapatkan koleksi semua simpul anak bernama phone yang ada di objek contact.

Dim contact As XElement = 
    <contact>
        <name>Patrick Hines</name>
        <phone type="home">206-555-0144</phone>
        <phone type="work">425-555-0145</phone>
    </contact>

Console.WriteLine("Phone number: " & contact.<phone>.Value)

Kode ini menampilkan teks berikut:

Phone number: 206-555-0144

Contoh 2

Contoh berikut menunjukkan cara mendapatkan nilai atribut XML dari kumpulan objek XAttribute. Contoh ini menggunakan properti sumbu atribut untuk menampilkan nilai atribut type untuk semua elemen phone.

Dim contact As XElement = 
    <contact>
      <name>Patrick Hines</name>
      <phone type="home">206-555-0144</phone>
      <phone type="work">425-555-0145</phone>
    </contact>


Dim types = contact.<phone>.Attributes("type")

For Each attr In types
  Console.WriteLine(attr.Value)
Next

Kode ini menampilkan teks berikut:

home
work

Lihat juga