Propriété d'axe descendant XML
Mise à jour : novembre 2007
Fournit l'accès aux descendants de l'un des éléments suivants : un objet XElement, un objet XDocument, une collection d'objets XElement ou une collection d'objets XDocument.
object...<descendant>
Éléments
object
Obligatoire. Un objet XElement, un objet XDocument, une collection d'objets XElement ou une collection d'objets XDocument....<
Obligatoire. Dénote le démarrage d'une propriété d'axe descendant.descendant
Obligatoire. Nom des nœuds descendants auxquels accéder, sous la forme [prefix:]name.Élément
Description
prefix
Facultatif. Préfixe d'espace de noms XML pour le nœud descendant. Doit être un espace de noms XML global défini à l'aide de l'instruction Imports.
name
Obligatoire. Nom local du nœud descendant. Consultez Nom des attributs et des éléments XML déclarés.
>
Obligatoire. Dénote la fin d'une propriété d'axe descendant.
Valeur de retour
Collection d'objets XElement.
Notes
Vous pouvez utiliser une propriété d'axe descendant XML pour accéder aux nœuds descendants par nom, à partir d'un objet XElement ou XDocument, ou d'une collection d'objets XElement ou XDocument. Utilisez la propriété XML Value pour accéder à la valeur du premier nœud descendant dans la collection retournée. Pour plus d'informations, consultez Propriété de valeur XML.
Le compilateur Visual Basic convertit des propriétés d'axes descendants en appels à la méthode Descendants.
Espaces de noms XML
Dans une propriété d'axe descendant, le nom ne peut utiliser que les espaces de noms XML déclarés globalement à l'aide de l'instruction Imports. Il ne peut utiliser d'espaces de noms XML déclarés localement dans les littéraux d'éléments XML. Pour plus d'informations, consultez Imports, instruction (espace de noms XML).
Exemple
L'exemple suivant indique comment accéder à la valeur du premier nœud descendant nommé name et aux valeurs de tous les nœuds descendants nommés phone à partir de l'objet contacts.
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))
Ce code affiche le texte suivant :
Name: Patrick Hines
Home Phone = 206-555-0144
L'exemple suivant déclare ns en tant que préfixe d'espace de noms XML. Il utilise alors le préfixe de l'espace de noms pour créer un littéral XML et accéder à la valeur du premier nœud enfant, avec le nom qualifié "ns:name".
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
Ce code affiche le texte suivant :
Name: Patrick Hines
Voir aussi
Concepts
Nom des attributs et des éléments XML déclarés