Properti Sumbu Keturunan XML (Visual Basic)

Artikel
04/07/2023

Menyediakan akses ke keturunan dari salah satu hal berikut: objek XElement, objek XDocument, kumpulan objek XElement, atau kumpulan objek XDocument.

Sintaks

object...<descendant>

Generator

object Diperlukan. Objek XElement, objek XDocument, kumpulan XElement objek, atau kumpulan XDocument objek.

...< Diperlukan. Menunjukkan awal properti sumbu keturunan.

descendant Diperlukan. Nama simpul keturunan untuk diakses, dari formulir [prefix:]name.

Bagian	Deskripsi
`prefix`	Opsional. Prefiks kumpulan nama XML untuk simpul keturunan. Harus berupa kumpulan nama XML global yang ditentukan menggunakan pernyataan `Imports`.
`name`	Harus diisi. Nama lokal simpul keturunan. Lihat Nama Elemen dan Atribut XML yang Dideklarasikan.

> Diperlukan. Menunjukkan akhir properti sumbu keturunan.

Tampilkan Nilai

Kumpulan XElement objek.

Keterangan

Anda dapat menggunakan properti sumbu keturunan XML untuk mengakses simpul keturunan berdasarkan nama dari objek XElement atau XDocument, atau dari kumpulan objek XElement atau XDocument. Gunakan properti XML Value untuk mengakses nilai simpul keturunan pertama dalam kumpulan yang dikembalikan. Untuk informasi selengkapnya, lihat Properti Nilai XML.

Pengompilasi Visual Basic mengubah properti sumbu keturunan menjadi panggilan ke metode Descendants.

Namespace XML

Nama dalam properti sumbu keturunan hanya dapat menggunakan prefikskumpulan nama XML yang dideklarasikan secara global dengan pernyataan Imports. Nama tersebut tidak dapat menggunakan kumpulan nama XML yang dideklarasikan secara lokal dalam harfiah elemen XML. Untuk informasi selengkapnya, lihat Pernyataan Impor (Namespace XML).

Contoh 1

Contoh berikut menunjukkan cara mengakses nilai simpul keturunan pertama bernama name dan nilai semua simpul keturunan bernama phone dari objek contacts.

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

Console.WriteLine("Name: " & contacts...<name>.Value)

Dim homePhone = From phone In contacts...<phone> 
                Select phone.Value

Console.WriteLine("Home Phone = {0}", homePhone(0))

Kode ini menampilkan teks berikut:

Name: Patrick Hines

Home Phone = 206-555-0144

Contoh 2

Contoh berikut mendeklarasikan ns sebagai awalan namespace XML. Kemudian menggunakan prefiks namespace layanan untuk membuat harfiah XML dan mengakses nilai node anak pertama dengan nama ns:name yang memenuhi syarat.

Imports <xmlns:ns = "http://SomeNamespace"> 
 
Class TestClass2

    Shared Sub TestPrefix()
        Dim contacts = 
            <ns:contacts>
                <ns:contact>
                    <ns:name>Patrick Hines</ns:name>
                </ns:contact>
            </ns:contacts>

        Console.WriteLine("Name: " & contacts...<ns:name>.Value)
    End Sub

End Class