Opérateur GetXmlNamespace (Visual Basic)

Article
06/08/2015

Obtient l'objet XNamespace qui correspond au préfixe d'espace de noms XML spécifié.

GetXmlNamespace(xmlNamespacePrefix)

Composants

xmlNamespacePrefix
Facultatif. Chaîne qui identifie le préfixe d'espace de noms XML. Si elle est fournie, cette chaîne doit être un identificateur XML valide. Pour plus d'informations, consultez Nom des attributs et des éléments XML déclarés (Visual Basic). Si aucun préfixe n'est spécifié, l'espace de noms par défaut est retourné. Si aucun espace de noms par défaut n'est spécifié, un espace de noms vide est retourné.

Valeur de retour

Objet XNamespace correspondant au préfixe d'espace de noms XML.

Notes

L'opérateur GetXmlNamespace obtient l'objet XNamespace correspondant au préfixe d'espace de noms XML xmlNamespacePrefix.

Vous pouvez utiliser directement les préfixes d'espace de noms XML dans les littéraux XML et les propriétés d'axe XML. Vous devez toutefois utiliser l'opérateur GetXmlNamespace pour convertir un préfixe d'espace de noms en un objet XNamespace, avant de pouvoir l'utiliser dans votre code. Vous pouvez ajouter un nom d'élément non qualifié à un objet XNamespace pour obtenir un objet XName qualifié complet, que de nombreuses méthodes LINQ to XML requièrent.

Exemple

L'exemple suivant importe ns en tant que préfixe d'espace de noms XML. Il utilise ensuite le préfixe d'espace de noms pour créer un littéral XML et accéder au premier nœud enfant avec le nom qualifié ns:phone. Il passe alors ce nœud enfant à la sous-routine ShowName, qui construit un nom qualifié en utilisant l'opérateur GetXmlNamespace. La sous-routine ShowName passe ensuite le nom qualifié à la méthode Ancestors pour obtenir le nœud parent ns:contact.

' Place Imports statements at the top of your program.   
Imports <xmlns:ns="http://SomeNamespace">

Module GetXmlNamespaceSample

    Sub RunSample()

        ' Create test by using a global XML namespace prefix.  

        Dim contact = 
            <ns:contact>
                <ns:name>Patrick Hines</ns:name>
                <ns:phone ns:type="home">206-555-0144</ns:phone>
                <ns:phone ns:type="work">425-555-0145</ns:phone>
            </ns:contact>

        ShowName(contact.<ns:phone>(0))
    End Sub 

    Sub ShowName(ByVal phone As XElement)
        Dim qualifiedName = GetXmlNamespace(ns) + "contact" 
        Dim contact = phone.Ancestors(qualifiedName)(0)
        Console.WriteLine("Name: " & contact.<ns:name>.Value)
    End Sub 

End Module

Lorsque vous appelez TestGetXmlNamespace.RunSample(), une boîte de message s'affiche, qui contient le texte suivant :

Name: Patrick Hines

Voir aussi

Référence

Imports, instruction (espace de noms XML)

Autres ressources

Accès au code XML dans Visual Basic

Partager via