Imports-Anweisung (XML-Namespace)

  • Artikel

Importiert XML-Namespacepräfixe für die Verwendung in XML-Literalen und XML-Achseneigenschaften.

Syntax

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

Bestandteile

xmlNamespacePrefix
Optional. Die Zeichenfolge, über die XML-Elemente und -Attribute auf xmlNamespaceName verweisen können. Ohne Angabe von xmlNamespacePrefix ist der importierte XML-Namespace der XML-Standardnamespace. Muss ein gültiger XML-Bezeichner sein. Weitere Informationen finden Sie unter Namen von deklarierten XML-Elementen und Attributen (Visual Basic).

xmlNamespaceName
Erforderlich. Die Zeichenfolge, die den zu importierenden XML-Namespace identifiziert.

Bemerkungen

Sie können die Imports-Anweisung verwenden, um globale XML-Namespaces zu definieren, die Sie mit XML-Literalen und XML-Achseneigenschaften oder als Parameter verwenden können, die an den GetXmlNamespace-Operator übergeben werden. (Informationen zur Verwendung der Imports-Anweisung zum Importieren eines Alias, der dort verwendet werden kann, wo Typnamen in Ihrem Code verwendet werden, finden Sie unter Imports-Anweisung (.NET-Namespace und Typ).) Die Syntax zum Deklarieren eines XML-Namespace mithilfe der Imports-Anweisung ist identisch mit der Syntax, die in XML verwendet wird. Daher können Sie eine Namespacedeklaration aus einer XML-Datei kopieren und in einer Imports-Anweisung verwenden.

XML-Namespacepräfixe sind nützlich, wenn Sie wiederholt XML-Elemente erstellen möchten, die aus dem gleichen Namespace stammen. Das mit der Imports-Anweisung deklarierte XML-Namespacepräfix ist global, was in diesem Fall bedeutet, dass es für den gesamten Code in der Datei verfügbar ist. Sie können es beim Erstellen von XML-Elementliteralen und beim Zugriff auf XML-Achseneigenschaften verwenden. Weitere Informationen finden Sie unter XML-Elementliteral (Visual Basic) sowie unter XML-Achseneigenschaften (Visual Basic).

Wenn Sie einen globalen XML-Namespace ohne Namespacepräfix definieren (z. B. Imports <xmlns="http://SomeNameSpace>"), wird dieser Namespace als XML-Standardnamespace betrachtet. Der XML-Standardnamespace wird für alle XML-Elementliterale oder XML-Attributachseneigenschaften verwendet, bei denen nicht explizit ein Namespace angeben ist. Der Standardnamespace wird auch verwendet, wenn der angegebene Namespace der leere Namespace (also xmlns="") ist. Der XML-Standardnamespace gilt nicht für XML-Attribute in XML-Literalen oder XML-Attributachseneigenschaften, die keinen Namespace haben.

XML-Namespaces, die in einem XML-Literal definiert sind (so genannte lokale XML-Namespaces), haben Vorrang vor XML-Namespaces, die durch die Imports-Anweisung als global definiert werden. XML-Namespaces, die durch die Imports-Anweisung definiert werden, haben Vorrang vor XML-Namespaces, die für ein Visual Basic-Projekt importiert werden. Wenn ein XML-Literal einen XML-Namespace definiert, gilt dieser lokale Namespace nicht für eingebettete Ausdrücke.

Globale XML-Namespaces folgen den gleichen Bereichs- und Definitionsregeln wie .NET Framework-Namespaces. Daher können Sie überall dort, wo Sie einen .NET Framework-Namespace importieren können, eine Imports-Anweisung einfügen, um einen globalen XML-Namespace zu definieren. Das gilt sowohl für Codedateien als auch für importierte Namespaces auf Projektebene. Informationen zu importierten Namespaces auf Projektebene finden Sie unter Seite „Verweise“, Projekt-Designer (Visual Basic).

Jede Quelldatei kann eine beliebige Anzahl von Imports-Anweisungen enthalten. Diese müssen auf Optionsdeklarationen folgen (beispielsweise auf die Option Strict-Anweisung) und vor Programmierelementdeklarationen platziert werden (beispielsweise vor Module- oder Class-Anweisungen).

Beispiel 1

Im folgenden Beispiel werden ein XML-Standardnamespace und ein XML-Namespace importiert, der mit dem Präfix ns identifiziert wird. Anschließend werden XML-Literale erstellt, die beide Namespaces verwenden.

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

Module Module1

  Sub Main()
    ' Create element by using the default global XML namespace. 
    Dim inner = <innerElement/>

    ' Create element by using both the default global XML namespace
    ' and the namespace identified with the "ns" prefix.
    Dim outer = <ns:outer>
                  <ns:innerElement></ns:innerElement>
                  <siblingElement></siblingElement>
                  <%= inner %>
                </ns:outer>

    ' Display element to see its final form. 
    Console.WriteLine(outer)
  End Sub

End Module

Durch diesen Code wird folgender Text angezeigt:

<ns:outer xmlns="http://DefaultNamespace"
          xmlns:ns="http://NewNamespace">
  <ns:innerElement></ns:innerElement>
  <siblingElement></siblingElement>
  <innerElement />
</ns:outer>

Beispiel 2

Im folgenden Beispiel wird das XML-Namespacepräfix ns importiert. Anschließend wird ein XML-Literal erstellt, das das Namespacepräfix verwendet und die endgültige Form des Elements anzeigt.

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

Class TestClass1

    Shared Sub TestPrefix()
        ' Create test using a global XML namespace prefix. 
        Dim inner2 = <ns:inner2/>

        Dim test = 
        <ns:outer>
            <ns:middle xmlns:ns="http://NewNamespace">
                <ns:inner1/>
                <%= inner2 %>
            </ns:middle>
        </ns:outer>

        ' Display test to see its final form. 
        Console.WriteLine(test)
    End Sub

End Class

Durch diesen Code wird folgender Text angezeigt:

<ns:outer xmlns:ns="http://SomeNamespace">
  <ns:middle xmlns:ns="http://NewNamespace">
    <ns:inner1 />
    <inner2 xmlns="http://SomeNamespace" />
  </ns:middle>
</ns:outer>

Beachten Sie, dass der Compiler das XML-Namespacepräfix von einem globalen Präfix in eine lokale Präfixdefinition konvertiert hat.

Beispiel 3

Im folgenden Beispiel wird das XML-Namespacepräfix ns importiert. Anschließend wird mit dem Namespacepräfix ein XML-Literal erstellt und auf den ersten untergeordneten Knoten mit dem qualifizierten Namen ns:name zugegriffen.

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

Durch diesen Code wird folgender Text angezeigt:

Patrick Hines

Siehe auch