Imports-Anweisung (XML-Namespace)
Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Imports-Anweisung (XML-Namespace)

Importiert XML-Namespacepräfixe zur Verwendung in XML-Literalen und XML-Achseneigenschaften.

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

xmlNamespacePrefix

Optional. Die Zeichenfolge, durch die XML-Elemente und Attribute auf xmlNamespaceName verweisen können. Wenn Sie keinen xmlNamespacePrefix angeben, wird der XML-Standardnamespace importiert. 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 angibt.

Mit der Imports-Anweisung können Sie globale XML-Namespaces definieren, die Sie für XML-Literale und XML-Achseneigenschaften oder als Parameter für den Operator GetXmlNamespace verwenden können. (Informationen zur Verwendung der Imports-Anweisung zum Importieren eines Alias, den Sie an den Stellen verwenden können, an denen im Code Typnamen verwendet werden, finden Sie unter Imports-Anweisung (.NET-Namespace und Typ).) Die Syntax zum Deklarieren eines XML-Namespaces mit 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 hilfreich, wenn Sie wiederholt XML-Elemente erstellen möchten, die aus demselben Namespace stammen. Ein mit der Imports-Anweisung deklarierter XML-Namespace ist in dem Sinne global, dass er für den gesamten Code in der Datei zur Verfügung steht. Sie können ihn beim Erstellen von XML-Elementliteralen und beim Zugreifen auf XML-Achseneigenschaften verwenden. Weitere Informationen finden Sie unter XML-Elementliteral (Visual Basic) und XML-Achseneigenschaften (Visual Basic).

Wenn Sie einen globalen XML-Namespace ohne einen Namespacepräfix definieren (z. B. Imports <xmlns="http://SomeNameSpace>"), wird dieser Namespace als der XML-Standardnamespace angesehen. Der XML-Standardnamespace wird für alle XML-Elementliterale oder XML-Attributachseneigenschaften verwendet, für die kein expliziter Namespace angegeben wird. Außerdem wird der Standardnamespace verwendet, wenn ein leerer Namespace (also xmlns="") angegeben wird. Der XML-Standardnamespace gilt nicht für XML-Attribute in XML-Literalen oder für XML-Attributachseneigenschaften ohne Namespace.

In einem XML-Literal definierte XML-Namespaces, die als lokale XML-Namespaces bezeichnet werden, haben Vorrang vor XML-Namespaces, die mit der Imports-Anweisung als global definiert werden. Mit der Imports-Anweisung definierte XML-Namespaces 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 denselben Bereichs- und Definitionsregeln wie .NET Framework-Namespaces. Aus diesem Grund können Sie eine Imports-Anweisung zum Definieren eines globalen XML-Namespaces auch an den Stellen angeben, an denen Sie einen .NET Framework-Namespace importieren können. Dies gilt sowohl für Codedateien als auch für auf Projektebene importierte Namespaces. Informationen über auf Projektebene importierte Namespaces finden Sie unter Seite "Verweise", Projekt-Designer (Visual Basic).

Jede Quelldatei kann beliebig viele Imports-Anweisungen enthalten. Diese müssen nach Option-Deklarationen, z. B. Option Strict, angegeben werden und Deklarationen von Programmierelementen, z. B. Module-Anweisungen oder Class-Anweisungen, vorangestellt werden.

Im folgenden Beispiel werden ein XML-Standardnamespace und ein mit dem Präfix ns gekennzeichneter 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


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>

Im folgenden Beispiel wird der XML-Namespacepräfix ns importiert. Anschließend wird ein XML-Literal erstellt, das das Namespacepräfix verwendet und die abschließende 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 das XML-Namespacepräfix vom Compiler von einer globalen Präfixdefinition in eine lokale Präfixdefinition umgewandelt wurde.

Im folgenden Beispiel wird der 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

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2016 Microsoft