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