Partager via


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

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>

Composants

  • 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 (Visual Basic).

  • >
    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 (Visual Basic).

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

Référence

XElement

Concepts

Nom des attributs et des éléments XML déclarés (Visual Basic)

Autres ressources

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

Littéraux XML (Visual Basic)

Création de code XML dans Visual Basic