Właściwości osi elementu podrzędnego XML (Visual Basic)

Artykuł
03/12/2024

Zapewnia dostęp do obiektów podrzędnych następujących: XElement obiektu, XDocument obiektu, kolekcji obiektów lub kolekcji XElement XDocument obiektów.

Składnia

object...<descendant>

generatora

object Wymagane. XElement Obiekt, XDocument obiekt, kolekcja XElement obiektów lub kolekcja XDocument obiektów.

...< Wymagane. Określa początek właściwości osi potomnej.

descendant Wymagane. Nazwa węzłów podrzędnych do uzyskania dostępu do formularza [prefix:]name.

Element	opis
`prefix`	Opcjonalny. Prefiks przestrzeni nazw XML dla węzła podrzędnego. Musi być globalną przestrzenią nazw XML zdefiniowaną przy użyciu instrukcji `Imports` .
`name`	Wymagany. Lokalna nazwa węzła podrzędnego. Zobacz Nazwy zadeklarowanych elementów XML i atrybutów.

> Wymagane. Określa koniec właściwości osi potomnej.

Wartość zwracana

Kolekcja obiektów XElement.

Uwagi

Możesz użyć właściwości osi potomnej XML, aby uzyskać dostęp do węzłów potomnych według nazwy z XElement obiektu lub XDocument lub kolekcji XElement obiektów lub XDocument . Użyj właściwości XML Value , aby uzyskać dostęp do wartości pierwszego węzła podrzędnego w zwróconej kolekcji. Aby uzyskać więcej informacji, zobacz Właściwość wartości XML.

Kompilator języka Visual Basic konwertuje właściwości osi potomnej na wywołania Descendants metody .

Przestrzenie nazw XML

Nazwa we właściwości osi potomnej może używać tylko przestrzeni nazw XML zadeklarowanych globalnie za pomocą instrukcji Imports . Nie może używać przestrzeni nazw XML zadeklarowanych lokalnie w literałach elementu XML. Aby uzyskać więcej informacji, zobacz Import Statement (XML Namespace).

Przykład 1

W poniższym przykładzie pokazano, jak uzyskać dostęp do wartości pierwszego węzła podrzędnego o nazwie name i wartości wszystkich węzłów podrzędnych nazwanych phone z contacts obiektu .

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

Ten kod wyświetla następujący tekst:

Name: Patrick Hines

Home Phone = 206-555-0144

Przykład 2

Poniższy przykład deklaruje ns jako prefiks przestrzeni nazw XML. Następnie używa prefiksu przestrzeni nazw, aby utworzyć literał XML i uzyskać dostęp do wartości pierwszego węzła podrzędnego o kwalifikowanej nazwie ns:name.

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