Bagikan melalui


Properti Sumbu Turunan XML (Visual Basic)

Menyediakan akses ke turunan dari berikut ini: XElement objek, XDocument objek, kumpulan XElement objek, atau kumpulan XDocument objek.

Sintaksis

object...<descendant>

Bagian

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

...< Diperlukan. Menunjukkan awal properti sumbu turunan.

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

Bagian Deskripsi
prefix Fakultatif. Awalan namespace XML untuk simpul turunan. Harus berupa namespace XML global yang ditentukan dengan menggunakan Imports pernyataan.
name Dibutuhkan. Nama lokal simpul turunan. Lihat Nama Elemen dan Atribut XML yang Dideklarasikan.

> Diperlukan. Menunjukkan akhir properti sumbu turunan.

Mengembalikan Nilai

Kumpulan XElement objek.

Komentar

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

Pengkompilasi Visual Basic mengonversi properti sumbu turunan menjadi panggilan ke Descendants metode .

Ruang Nama XML

Nama dalam properti sumbu turunan hanya dapat menggunakan namespace XML yang dideklarasikan secara global dengan pernyataan .Imports Ini tidak dapat menggunakan namespace XML yang dideklarasikan secara lokal dalam literal elemen XML. Untuk informasi selengkapnya, lihat Pernyataan Impor (Namespace XML).

Contoh 1

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

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 awalan namespace layanan untuk membuat XML literal dan mengakses nilai node anak pertama dengan nama ns:nameyang 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

Kode ini menampilkan teks berikut:

Name: Patrick Hines

Lihat juga