Propriété d'axe enfant XML
Mise à jour : novembre 2007
Fournit l'accès aux enfants 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.<child>
É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 enfant.child
Obligatoire. Nom des nœuds enfants auxquels accéder, sur le formulaire [prefix:]name.Élément
Description
prefix
Facultatif. Préfixe d'espace de noms XML pour le nœud enfant. Doit être un espace de noms XML global, défini avec une instruction Imports.
name
Obligatoire. Nom de nœud enfant local. Consultez Nom des attributs et des éléments XML déclarés.
>
Obligatoire. Dénote la fin d'une propriété d'axe enfant.
Valeur de retour
Collection d'objets XElement.
Notes
Vous pouvez utiliser une propriété d'axe enfant XML pour accéder aux nœuds enfants par nom, à partir d'un objet XElement ou XDocument, d'une collection d'objets XElement ou d'objets XDocument. Utilisez la propriété XML Value pour accéder à la valeur du premier nœud enfant 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 enfants en appels à la méthode Elements.
Espaces de noms XML
Le nom dans une propriété d'axe enfant ne peut utiliser que des préfixes d'espaces de noms XML, déclarés globalement avec l'instruction Imports. Il ne peut pas utiliser de préfixes d'espaces de noms XML déclarés localement dans des 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 aux nœuds enfants nommés phone à partir de l'objet contact.
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)
Ce code affiche le texte suivant :
Home Phone = 206-555-0144
L'exemple suivant illustre l'accès aux nœuds enfants nommés phone à partir de la collection retournée par la propriété d'axe enfant contact de l'objet contacts.
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)
Ce code affiche le texte suivant :
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 au premier nœud enfant avec le nom qualifié ns:name.
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
Ce code affiche le texte suivant :
Patrick Hines
Voir aussi
Concepts
Nom des attributs et des éléments XML déclarés