Freigeben über

UNTERGEORDNETE XML-Achseneigenschaft (Visual Basic)

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

Syntax

object.<child>

Bestandteile

Begriff Definition
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.
child Erforderlich. Name der untergeordneten Knoten, auf die zugegriffen werden soll, des Formulars [prefix:]name.

- Prefix -Wahlfrei. XML-Namespacepräfix für den untergeordneten Knoten. Muss ein globaler XML-Namespace sein, der mit einer Imports Anweisung definiert ist.
- Name -Erforderlich. Name des lokalen 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 untergeordnete XML-Achseneigenschaft verwenden, um auf untergeordnete Knoten über einen XElementXDocument Namen oder ein 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 untergeordnete Achseneigenschaften in Aufrufe der Elements Methode.

XML-Namespaces

Der Name in einer untergeordneten Achseneigenschaft kann nur XML-Namespacepräfixe verwenden, die global mit der Imports Anweisung deklariert wurden. Xml-Namespacepräfixe, 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 die untergeordneten Knoten zugreifen, die aus dem contact Objekt benannt sindphone.

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)

Dieser Code zeigt den folgenden Text an:

Home Phone = 206-555-0144

Beispiel 2

Das folgende Beispiel zeigt, wie Sie auf die untergeordneten Knoten phone zugreifen, die aus der Auflistung benannt werden, die von der contact untergeordneten Achseneigenschaft des contacts Objekts zurückgegeben wird.

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)

Dieser Code zeigt den folgenden Text an:

Home Phone = 206-555-0144

Beispiel 3

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 ersten untergeordneten Knoten mit dem qualifizierten Namen ns:namezuzugreifen.

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

Dieser Code zeigt den folgenden Text an:

Patrick Hines

Siehe auch

  • Last updated on