Teilen über


GetXmlNamespace-Operator (Visual Basic)

Ruft das XNamespace Objekt ab, das dem angegebenen XML-Namespacepräfix entspricht.

Syntax

GetXmlNamespace(xmlNamespacePrefix)

Bestandteile

xmlNamespacePrefix Wahlfrei. Die Zeichenfolge, die das XML-Namespacepräfix identifiziert. Wenn diese Zeichenfolge angegeben wird, muss es sich um einen gültigen XML-Bezeichner handeln. Weitere Informationen finden Sie unter Namen deklarierter XML-Elemente und -Attribute. Wenn kein Präfix angegeben ist, wird der Standardnamespace zurückgegeben. Wenn kein Standardnamespace angegeben ist, wird der leere Namespace zurückgegeben.

Rückgabewert

Das XNamespace Objekt, das dem XML-Namespacepräfix entspricht.

Bemerkungen

Der GetXmlNamespace Operator ruft das XNamespace Objekt ab, das dem XML-Namespacepräfix xmlNamespacePrefixentspricht.

Sie können XML-Namespacepräfixe direkt in XML-Literalen und XML-Achseneigenschaften verwenden. Sie müssen jedoch den GetXmlNamespace Operator verwenden, um ein Namespacepräfix in ein XNamespace Objekt zu konvertieren, bevor Sie es in Ihrem Code verwenden können. Sie können einen nicht qualifizierten Elementnamen an ein XNamespace Objekt anfügen, um ein vollqualifiziertes XName Objekt abzurufen, das viele LINQ to XML-Methoden erfordern.

Beispiel

Im folgenden Beispiel wird ein XML-Namespacepräfix importiert ns . Anschließend wird das Präfix des Namespace verwendet, um ein XML-Literal zu erstellen und auf den ersten untergeordneten Knoten zuzugreifen, der über den qualifizierten Namen ns:phoneverfügt. Anschließend wird dieser untergeordnete Knoten an die ShowName Unterroutine übergeben, die einen qualifizierten Namen mithilfe des GetXmlNamespace Operators erstellt. Die ShowName Unterroutine übergibt dann den qualifizierten Namen an die Ancestors Methode, um den übergeordneten ns:contact Knoten abzurufen.

' 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

Beim Aufrufen TestGetXmlNamespace.RunSample()wird ein Meldungsfeld mit folgendem Text angezeigt:

Name: Patrick Hines

Siehe auch