Untergeordnete XML-Achseneigenschaft
Aktualisiert: November 2007
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
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.Bestandteil
Beschreibung
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. Siehe Namen von deklarierten XML-Elementen und Attributen.
>
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.
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
Konzepte
Namen von deklarierten XML-Elementen und Attributen