GetXmlNamespace-Operator (Visual Basic)

  • Artikel

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

Syntax

GetXmlNamespace(xmlNamespacePrefix)

Bestandteile

xmlNamespacePrefix ist optional. Die Zeichenfolge, die das XML-Namespacepräfix identifiziert. Wenn angegeben, muss diese Zeichenfolge ein gültiger XML-Bezeichner sein. Weitere Informationen finden Sie unter Namen von deklarierten XML-Elementen und Attributen (Visual Basic). 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-Namespace-Präfix entspricht.

Bemerkungen

Der GetXmlNamespace-Operator ruft das XNamespace-Objekt ab, das dem angegebenen XML-Namespace-Präfix xmlNamespacePrefix entspricht.

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 im Code verwenden können. Sie können einen nicht qualifizierten Elementnamen an ein XNamespace-Objekt anfügen, um ein vollqualifiziertes XName-Objekt abzurufen, was viele LINQ to XML Methoden erfordern.

Beispiel

Im folgenden Beispiel wird ns als XML-Namespacepräfix importiert. Anschließend wird mit dem Namespacepräfix ein XML-Literal erstellt und auf den ersten untergeordneten Knoten mit dem qualifizierten Namen ns:phone zugegriffen. Anschließend übergibt er diesen untergeordneten Knoten an die ShowName-Unterroutine, die einen qualifizierten Namen mit dem GetXmlNamespace-Operator 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

Wenn Sie TestGetXmlNamespace.RunSample() aufrufen, wird ein Meldungsfeld angezeigt, das den folgenden Text enthält:

Name: Patrick Hines

Siehe auch