XML Child Axis, propriété (Visual Basic)

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.

Syntaxe

object.<child>

Pièces

Valeur de retour

Collection d’objets XElement.

Remarques

Vous pouvez utiliser une propriété d’axe enfant XML pour accéder aux nœuds enfants par nom à partir d’un ou d’un XElement objet ou d’une collection d’objets XDocumentXElement.XDocument Utilisez la propriété XML Value pour accéder à la valeur du premier nœud enfant de la collection retournée. Pour plus d’informations, consultez XML Value, propriété.

Le compilateur Visual Basic convertit les propriétés de l’axe enfant en appels à la Elements méthode.

Espaces de noms XML

Le nom d’une propriété d’axe enfant peut utiliser uniquement les préfixes d’espace de noms XML déclarés globalement avec l’instruction Imports . Il ne peut pas utiliser les préfixes d’espace de noms XML déclarés localement dans les littéraux d’élément XML. Pour plus d’informations, consultez Imports Statement (XML Namespace).

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é de l’axe contact enfant 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 comme 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 ns:namequalifié.

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

• XElement
• Propriétés de l’axe XML
• Littéraux XML
• Création de code XML en Visual Basic
• Noms des éléments et attributs XML déclarés