XML Descendant Axis Özelliği (Visual Basic)

  • Makale

Aşağıdakilerin alt öğelerine erişim sağlar: nesne XElement , XDocument nesne, nesne koleksiyonu XElement veya nesne koleksiyonu XDocument .

Sözdizimi

object...<descendant>

Parça

object Gerekli. Nesne XElement , XDocument nesne, nesne koleksiyonu XElement veya nesne koleksiyonu XDocument .

...< Gerekli. Alt eksen özelliğinin başlangıcını belirtir.

descendant Gerekli. [prefix:]name. formun erişecek alt düğümlerinin adı.

Bölüm Açıklama
prefix isteğe bağlı. Alt düğüm için XML ad alanı ön eki. Deyimi kullanılarak Imports tanımlanan bir genel XML ad alanı olmalıdır.
name Gerekli. Alt düğümün yerel adı. Bkz. Bildirilen XML Öğelerinin ve Özniteliklerinin Adları.

> Gerekli. Alt eksen özelliğinin sonunu belirtir.

Dönüş Değeri

XElement nesneleri topluluğu.

Açıklamalar

Bir veya nesnesinden veya bir veya XDocument nesne koleksiyonundan XDocumentXElementXElement gelen ada göre alt düğümlere erişmek için BIR XML alt eksen özelliği kullanabilirsiniz. Döndürülen koleksiyondaki ilk alt düğümün değerine erişmek için XML Value özelliğini kullanın. Daha fazla bilgi için bkz . XML Değeri Özelliği.

Visual Basic derleyicisi, alt eksen özelliklerini yöntemine yapılan çağrılara Descendants dönüştürür.

XML Ad Alanları

Alt eksen özelliğindeki ad yalnızca deyimiyle Imports genel olarak bildirilen XML ad alanlarını kullanabilir. XML öğesi değişmez değerleri içinde yerel olarak bildirilen XML ad alanlarını kullanamaz. Daha fazla bilgi için bkz . Imports Deyimi (XML Ad Alanı).

Örnek 1

Aşağıdaki örnek, adlı name ilk alt düğümün değerine ve nesnesinden adlı phone tüm alt düğümlerin değerlerine nasıl eriş yapılacağını contacts gösterir.

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))

Bu kod aşağıdaki metni görüntüler:

Name: Patrick Hines

Home Phone = 206-555-0144

Örnek 2

Aşağıdaki örnekte XML ad alanı ön eki olarak bildirmektedir ns . Ardından ad alanının ön ekini kullanarak bir XML değişmez değeri oluşturur ve nitelenmiş adıyla ns:nameilk alt düğümün değerine erişir.

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

Bu kod aşağıdaki metni görüntüler:

Name: Patrick Hines

Ayrıca bkz.