Freigeben über

XML Descendant Axis-Eigenschaft (Visual Basic)

Bietet Zugriff auf die Nachfolger der folgenden Objekte: ein XElement Objekt, ein XDocument Objekt, eine Auflistung von XElement Objekten oder eine Auflistung von XDocument Objekten.

Syntax

object...<descendant>

Bestandteile

object Erforderlich. Ein XElement Objekt, ein XDocument Objekt, eine Auflistung von XElement Objekten oder eine Auflistung von XDocument Objekten.

...< Erforderlich. Gibt den Anfang einer untergeordneten Achseneigenschaft an.

descendant Erforderlich. Name der untergeordneten Knoten, auf die zugegriffen werden soll, des Formulars [prefix:]name.

Teil BESCHREIBUNG
prefix Wahlfrei. XML-Namespacepräfix für den untergeordneten Knoten. Muss ein globaler XML-Namespace sein, der mithilfe einer Imports Anweisung definiert wird.
name Erforderlich. Lokaler Name des untergeordneten Knotens. Siehe Namen deklarierter XML-Elemente und -Attribute.

> Erforderlich. Gibt das Ende einer untergeordneten Achseneigenschaft an.

Rückgabewert

Eine Auflistung von XElement -Objekten.

Bemerkungen

Sie können eine XML-Eigenschaft für untergeordnete Achsen verwenden, um auf untergeordnete Knoten über einen Namen oder ein XElementXDocument Objekt oder eine Auflistung von XElement Objekten XDocument zuzugreifen. Verwenden Sie die XML-Eigenschaft Value , um auf den Wert des ersten untergeordneten Knotens in der zurückgegebenen Auflistung zuzugreifen. Weitere Informationen finden Sie unter XML-Werteigenschaft.

Der Visual Basic-Compiler konvertiert die Eigenschaften der untergeordneten Achse in Aufrufe der Descendants Methode.

XML-Namespaces

Der Name in einer Untergeordneten Achseneigenschaft kann nur XML-Namespaces verwenden, die global mit der Imports Anweisung deklariert werden. Xml-Namespaces, die lokal innerhalb von XML-Elementliteralen deklariert werden, können nicht verwendet werden. Weitere Informationen finden Sie unter Imports-Anweisung (XML-Namespace).

Beispiel 1

Das folgende Beispiel zeigt, wie Sie auf den Wert des ersten untergeordneten Knotens mit dem Namen name und die Werte aller untergeordneten Knoten zugreifen, die aus dem contacts Objekt benannt phone werden.

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

Dieser Code zeigt den folgenden Text an:

Name: Patrick Hines

Home Phone = 206-555-0144

Beispiel 2

Im folgenden Beispiel wird als XML-Namespacepräfix deklariert ns . Anschließend wird das Präfix des Namespace verwendet, um ein XML-Literal zu erstellen und auf den Wert des ersten untergeordneten Knotens mit dem qualifizierten Namen ns:namezuzugreifen.

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

Dieser Code zeigt den folgenden Text an:

Name: Patrick Hines

Siehe auch

  • Last updated on