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 XElementObjekt, ein XDocument-Objekt, eine Auflistung von XElementObjekten 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, in der Form [prefix:]name.- 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. |
| > | 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 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 dazu finden Sie unter XML-Werteigenschaft.
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 1
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
Beispiel 2
Im folgenden Beispiel wird dargestellt, wie auf die untergeordneten Knoten mit dem Namen phone aus der Auflistung zugegriffen werden kann, die von der untergeordneten contact-Achseneigenschaft 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
Beispiel 3
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
