Propriété d'axe enfant XML (Visual Basic)

  • Article

Fournit un 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.

Syntaxe

object.<child>

Éléments

Terme Définition
object Obligatoire. Un objet XElement, un objet XDocument, une collection d’objets XElement ou une collection d’objets XDocument.
.< Obligatoire. Indique le début d'une propriété d'axe enfant.
child Obligatoire. Nom des nœuds enfants auxquels accéder, de la forme [prefix:]name.

- 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 Noms des éléments et attributs XML déclarés.
> Obligatoire. Indique la fin d'une propriété d'axe enfant.

Valeur renvoyée

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, ou à partir d'une collection d'objets XElement ou 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 les propriétés d'axes enfants en appels à la méthode Elements.

Espaces de noms XML

Le nom inclus dans une propriété d'axe enfant peut utiliser uniquement des préfixes d'espace de noms XML déclarés globalement à l'aide de l'instruction Imports. Il ne peut pas utiliser des préfixes d'espace 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 1

L'exemple suivant montre 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

Exemple 2

L’exemple suivant montre comment accéder 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

Exemple 3

L'exemple suivant déclare ns en tant que préfixe d'espace de noms XML. Il utilise ensuite 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