Freigeben über


Untergeordnete XML-Achseneigenschaft (Visual Basic)

Ermöglicht den Zugriff auf die untergeordneten Elemente eines der folgenden Objekte: eines XElement-Objekts, eines XDocument-Objekts, einer Auflistung von XElement-Objekten oder einer Auflistung von XDocument-Objekten.

object.<child>

Bestandteile

Ausdruck

Definition

object

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

.<

Erforderlich. Kennzeichnet den Anfang einer untergeordneten Achseneigenschaft.

child

Erforderlich. Name der untergeordneten Knoten, auf die zugegriffen werden soll, in der Form [prefix:]name.

BestandteilBeschreibung
prefix Optional.XML-Namespacepräfix für den untergeordneten Knoten.Muss ein globaler XML-Namespace sein, der mit einer Imports-Anweisung definiert ist.
name Erforderlich.Lokaler Name des untergeordneten Knotens.Weitere Informationen finden Sie unter Namen von deklarierten XML-Elementen und Attributen (Visual Basic).

>

Erforderlich. Kennzeichnet das Ende einer untergeordneten Achseneigenschaft.

Rückgabewert

Eine Auflistung von XElement-Objekten.

Hinweise

Sie können eine untergeordnete XML-Achseneigenschaft verwenden, um auf untergeordnete Knoten 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 auf den Wert des ersten untergeordneten Knotens in der zurückgegebenen Auflistung zuzugreifen. Weitere Informationen finden Sie unter XML-Value-Eigenschaft (Visual Basic).

Der Visual Basic-Compiler konvertiert die untergeordneten Achseneigenschaften in Aufrufe an die Elements-Methode.

XML-Namespaces

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

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie auf die untergeordneten Knoten mit dem Namen phone aus dem contact-Objekt zugegriffen werden kann.

Dim contact As XElement = 
    <contact>
        <name>Patrick Hines</name>
        <phone type="home">206-555-0144</phone>
        <phone type="work">425-555-0145</phone>
    </contact>

Dim homePhone = From hp In contact.<phone> 
                Where contact.<phone>.@type = "home" 
                Select hp

Console.WriteLine("Home Phone = {0}", homePhone(0).Value)

Durch diesen Code wird folgender Text angezeigt:

Home Phone = 206-555-0144

Im folgenden Beispiel wird dargestellt, wie auf die untergeordneten Knoten mit dem Namen phone aus der Auflistung zugegriffen werden kann, die von der untergeordneten Achseneigenschaft contact des contacts-Objekts zurückgegeben wurde.

Dim contacts As XElement = 
    <contacts>
        <contact>
            <name>Patrick Hines</name>
            <phone type="home">206-555-0144</phone>
        </contact>
        <contact>
            <name>Lance Tucker</name>
            <phone type="work">425-555-0145</phone>
        </contact>
    </contacts>

Dim homePhone = From contact In contacts.<contact> 
                Where contact.<phone>.@type = "home" 
                Select contact.<phone>

Console.WriteLine("Home Phone = {0}", homePhone(0).Value)

Durch diesen Code wird folgender Text angezeigt:

Home Phone = 206-555-0144

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

Imports <xmlns:ns = "http://SomeNamespace"> 

Class TestClass4

    Shared Sub TestPrefix()
        Dim contact = <ns:contact>
                        <ns:name>Patrick Hines</ns:name>
                      </ns:contact>
        Console.WriteLine(contact.<ns:name>.Value)
    End Sub

End Class

Durch diesen Code wird folgender Text angezeigt:

Patrick Hines

Siehe auch

Referenz

XElement

Konzepte

Namen von deklarierten XML-Elementen und Attributen (Visual Basic)

Weitere Ressourcen

XML-Achseneigenschaften (Visual Basic)

XML-Literale (Visual Basic)

Erstellen von XML in Visual Basic