XML-Nachfolger-Achseneigenschaft
Aktualisiert: November 2007
Ermöglicht Zugriff auf folgende Nachfolgerelemente: ein XElement-Objekt, ein XDocument-Objekt, eine Auflistung von XElement-Objekten oder eine Auflistung von XDocument-Objekten.
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 Start einer untergeordneten Achseneigenschaft an.descendant
Erforderlich. Name der Nachfolgerknoten, um zuzugreifen, vom Formular [prefix:]name.Bestandteil
Beschreibung
prefix
Optional. XML-Namespacepräfix für den untergeordneten Knoten. Muss ein globaler XML-Namespace sein, der durch eine Imports-Anweisung definiert wird.
name
Erforderlich. Der lokale Name der untergeordneten Knoten. Siehe Namen von deklarierten XML-Elementen und Attributen.
>
Erforderlich. Gibt das Ende einer untergeordneten Achseneigenschaft an.
Rückgabewert
Eine Auflistung von XElement-Objekten.
Hinweise
Sie können eine untergeordnete XML-Achseneigenschaft verwenden, um nach Name auf untergeordnete Knoten von einem XElement-Objekt oder einem XDocument-Objekt bzw. von einer Auflistung von XElement-Objekten oder XDocument-Objekten zuzugreifen. Verwenden Sie die XML-Value-Eigenschaft, um auf den Wert des ersten untergeordneten Knoten 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 Descendants-Methode.
XML-Namespaces
Für den Namen in einer untergeordneten Achseneigenschaft können nur XML-Namespaces verwendet werden, die mit der Imports-Anweisung global deklariert wurden. Es können keine XML-Namespaces verwendet werden, die lokal innerhalb von XML-Elementliteralen deklariert wurden. Weitere Informationen finden Sie unter Imports-Anweisung (XML-Namespace).
Beispiel
Im folgenden Beispiel wird gezeigt, wie auf den Wert des ersten untergeordneten Knotens mit dem Namen name und die Werte aller untergeordneten Knoten mit dem Namen phone aus dem contacts-Objekt zugegriffen wird.
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))
Durch diesen Code wird folgender Text angezeigt:
Name: Patrick Hines
Home Phone = 206-555-0144
Das folgende Beispiel deklariert ns als ein XML-Namespacepräfix. Anschließend wird das Namespacepräfix verwendet, um ein XML-Literal zu erstellen und auf den ersten Wert des untergeordneten Knotens mit dem qualifizierten Namen ns:name zuzugreifen.
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
Durch diesen Code wird folgender Text angezeigt:
Name: Patrick Hines
Siehe auch
Konzepte
Namen von deklarierten XML-Elementen und Attributen