XML-Nachfolgerachseneigenschaft (Visual Basic)

2023-06-19

Bietet Zugriff auf die Nachfolger eines XElement-Objekts, eines XDocument-Objekts, einer Auflistung von XElement-Objekten oder einer Auflistung von XDocument-Objekten.

Syntax

object...<descendant>

Bestandteile

object ist erforderlich. Ein XElementObjekt, ein XDocument-Objekt, eine Auflistung von XElementObjekten oder eine Auflistung von XDocument-Objekten.

...< ist erforderlich. Gibt den Anfang einer Nachfolgerachseneigenschaft an.

descendant ist erforderlich. Name der Nachfolgerknoten, auf die zugegriffen werden soll, in der Form [prefix:]name.

Teil	Beschreibung
`prefix`	Optional. XML-Namespacepräfix für den Nachfolgerknoten. Dies muss ein globaler XML-Namespace sein, der mithilfe einer `Imports`-Anweisung definiert wird.
`name`	Erforderlich. Lokaler Name des Nachfolgerknotens. Weitere Informationen finden Sie unter Namen von deklarierten XML-Elementen und -Attributen.

> ist erforderlich. Gibt das Ende einer Nachfolgerachseneigenschaft an.

Rückgabewert

Eine Auflistung von XElement-Objekten.

Bemerkungen

Sie können eine XML-Nachfolgerachseneigenschaft verwenden, um auf Nachfolgerknoten eines XElement-Objekts oder eines XDocument-Objekts bzw. einer Auflistung von XElement-Objekten oder XDocument-Objekten über den Namen zuzugreifen. Verwenden Sie die XML-Value-Eigenschaft, um in der zurückgegebenen Auflistung auf den Wert des ersten Nachfolgerknotens zuzugreifen. Weitere Informationen dazu finden Sie unter XML-Werteigenschaft.

Der Visual Basic-Compiler konvertiert Nachfolgerachseneigenschaften in Aufrufe der Descendants-Methode.

XML-Namespaces

Für den Namen in einer Nachfolgerachseneigenschaft können nur XML-Namespaces verwendet werden, die mit der Imports-Anweisung global deklariert wurden. Es können keine XML-Namespaces verwendet werden, die lokal innerhalb von XML-Elementliteralen deklariert wurden. Weitere Informationen finden Sie unter Imports-Anweisung (XML-Namespace).

Beispiel 1

Das folgende Beispiel zeigt, wie Sie auf den Wert des ersten Nachfolgerknotens mit der Bezeichnung name und auf die Werte aller Nachfolgerknoten mit der Bezeichnung phone aus dem contacts-Objekt zugreifen.

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

Durch diesen Code wird folgender Text angezeigt:

Name: Patrick Hines

Home Phone = 206-555-0144

Beispiel 2

Das folgende Beispiel deklariert ns als ein XML-Namespacepräfix. Anschließend wird mit dem Namespace ein XML-Literal erstellt und auf den Wert des ersten untergeordneten Knotens mit dem qualifizierten Namen ns:name zugegriffen.

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