Freigeben über

Imports-Anweisung (XML-Namespace)

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

Syntax

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

Bestandteile

xmlNamespacePrefix
Wahlfrei. Die Zeichenfolge, auf die XML-Elemente und -Attribute verweisen xmlNamespaceNamekönnen. Wenn keine xmlNamespacePrefix angegeben wird, ist der importierte XML-Namespace der Standard-XML-Namespace. Muss ein gültiger XML-Bezeichner sein. Weitere Informationen finden Sie unter Namen deklarierter XML-Elemente und -Attribute.

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 verwenden können, oder als Parameter, die an den GetXmlNamespace Operator übergeben werden. (Informationen zur Verwendung der Imports Anweisung zum Importieren eines Alias, der verwendet werden kann, wo Typnamen in Ihrem Code verwendet werden, finden Sie unter Imports-Anweisung (.NET-Namespace und Type).) Die Syntax zum Deklarieren eines XML-Namespace mithilfe der Imports Anweisung ist identisch mit der in XML verwendeten Syntax. 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 aus demselben Namespace erstellen möchten. Das mit der Imports Anweisung deklarierte XML-Namespacepräfix ist global, sodass es für den gesamten Code in der Datei verfügbar ist. Sie können es verwenden, wenn Sie XML-Elementliterale erstellen und auf XML-Achseneigenschaften zugreifen. Weitere Informationen finden Sie unter XML-Elementliteral- und XML-Achseneigenschaften.

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

XML-Namespaces, die in einem XML-Literal definiert sind, die als lokale XML-Namespaces bezeichnet werden, haben Vorrang vor XML-Namespaces, die von der 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 wurden. 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 eine Imports Anweisung einfügen, um einen globalen XML-Namespace an beliebiger Stelle zu definieren, an der Sie einen .NET Framework-Namespace importieren können. Dazu gehören sowohl Codedateien als auch importierte Namespaces auf Projektebene. Informationen zu importierten Namespaces auf Projektebene finden Sie auf der Seite "Verweise", "Project Designer" (Visual Basic).For information about project-level imported namespaces, see References Page, Project Designer (Visual Basic).

Jede Quelldatei kann eine beliebige Anzahl von Imports Anweisungen enthalten. Diese müssen Optionsdeklarationen folgen, z. B. die Option Strict Anweisung, und sie müssen Programmierelementdeklarationen, z Module . B. oder Class Anweisungen, vorangehen.

Beispiel 1

Im folgenden Beispiel wird ein STANDARDMÄßIGer XML-Namespace und ein MIT dem Präfix nsidentifizierter XML-Namespace importiert. 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

Dieser Code zeigt den folgenden Text an:

<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 nsimportiert. Anschließend wird ein XML-Literal erstellt, das das Namespacepräfix verwendet und das endgültige Formular 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

Dieser Code zeigt den folgenden Text an:

<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 nsimportiert. Anschließend wird das Präfix des Namespace verwendet, um ein XML-Literal zu erstellen und auf den ersten untergeordneten Knoten mit dem qualifizierten Namen ns:namezuzugreifen.

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

Dieser Code zeigt den folgenden Text an:

Patrick Hines

Siehe auch

  • Last updated on