Delen via

Importinstructie (XML-naamruimte)

  • Artikel

Hiermee importeert u voorvoegsels voor XML-naamruimten voor gebruik in letterlijke XML-waarden en XML-aseigenschappen.

Syntaxis

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

generator

xmlNamespacePrefix
Optioneel. De tekenreeks waarmee XML-elementen en -kenmerken kunnen verwijzen xmlNamespaceName. Als er geen is xmlNamespacePrefix opgegeven, is de geïmporteerde XML-naamruimte de standaard-XML-naamruimte. Moet een geldige XML-id zijn. Zie De namen van gedeclareerde XML-elementen en -kenmerken voor meer informatie.

xmlNamespaceName
Vereist. De tekenreeks die de XML-naamruimte identificeert die wordt geïmporteerd.

Opmerkingen

U kunt de Imports instructie gebruiken om globale XML-naamruimten te definiëren die u kunt gebruiken met de eigenschappen xml-letterlijke waarden en XML-as, of als parameters die aan de GetXmlNamespace operator worden doorgegeven. (Zie importinstructie (.NET-naamruimte en -type) voor informatie over het gebruik van de Imports instructie voor het importeren van een alias die kan worden gebruikt waar typenamen in uw code worden gebruikt.) De syntaxis voor het declareren van een XML-naamruimte met behulp van de Imports instructie is identiek aan de syntaxis die in XML wordt gebruikt. Daarom kunt u een naamruimtedeclaratie uit een XML-bestand kopiëren en gebruiken in een Imports instructie.

XML-naamruimtevoorvoegsels zijn handig als u herhaaldelijk XML-elementen wilt maken die afkomstig zijn van dezelfde naamruimte. Het voorvoegsel van de XML-naamruimte die met de Imports instructie is gedeclareerd, is globaal in de zin dat het beschikbaar is voor alle code in het bestand. U kunt dit gebruiken wanneer u letterlijke waarden voor XML-elementen maakt en wanneer u de eigenschappen van de XML-as opent. Zie eigenschappen voor letterlijke xml-elementen en XML-as voor meer informatie.

Als u een algemene XML-naamruimte definieert zonder een naamruimtevoorvoegsel (bijvoorbeeld Imports <xmlns="http://SomeNameSpace>"), wordt die naamruimte beschouwd als de standaard-XML-naamruimte. De standaard-XML-naamruimte wordt gebruikt voor letterlijke eigenschappen van XML-elementen of XML-kenmerkaseigenschappen die geen naamruimte expliciet opgeven. De standaardnaamruimte wordt ook gebruikt als de opgegeven naamruimte de lege naamruimte is (dat wil gezegd, xmlns=""). De standaard-XML-naamruimte is niet van toepassing op XML-kenmerken in letterlijke XML-waarden of op eigenschappen van de XML-kenmerkas die geen naamruimte hebben.

XML-naamruimten die zijn gedefinieerd in een letterlijke XML-naamruimte, die lokale XML-naamruimten worden genoemd, hebben voorrang op XML-naamruimten die door de Imports instructie zijn gedefinieerd als globaal. XML-naamruimten die door de Imports instructie zijn gedefinieerd, hebben voorrang op XML-naamruimten die zijn geïmporteerd voor een Visual Basic-project. Als een LETTERLIJKe XML-naamruimte een XML-naamruimte definieert, is die lokale naamruimte niet van toepassing op ingesloten expressies.

Globale XML-naamruimten volgen dezelfde bereik- en definitieregels als .NET Framework-naamruimten. Als gevolg hiervan kunt u een Imports instructie opnemen om een algemene XML-naamruimte te definiëren waar u een .NET Framework-naamruimte kunt importeren. Dit omvat zowel codebestanden als geïmporteerde naamruimten op projectniveau. Zie Referentiepagina, Project Designer (Visual Basic) voor informatie over geïmporteerde naamruimten op projectniveau.

Elk bronbestand kan een willekeurig aantal Imports instructies bevatten. Deze moeten optiedeclaraties volgen, zoals de Option Strict instructie, en ze moeten voorafgaan aan declaraties van programmeerelementen, zoals Module of Class instructies.

Voorbeeld 1

In het volgende voorbeeld wordt een standaard XML-naamruimte en een XML-naamruimte geïmporteerd die is geïdentificeerd met het voorvoegsel ns. Vervolgens worden XML-letterlijke tekens gemaakt die beide naamruimten gebruiken.

' 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

Met deze code wordt de volgende tekst weergegeven:

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

Voorbeeld 2

In het volgende voorbeeld wordt het voorvoegsel nsvan de XML-naamruimte geïmporteerd. Vervolgens wordt een LETTERLIJKE XML-naam gemaakt die gebruikmaakt van het voorvoegsel van de naamruimte en het uiteindelijke formulier van het element weergeeft.

' 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

Met deze code wordt de volgende tekst weergegeven:

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

U ziet dat de compiler het voorvoegsel van de XML-naamruimte van een globaal voorvoegsel heeft geconverteerd naar een definitie van een lokaal voorvoegsel.

Voorbeeld 3

In het volgende voorbeeld wordt het voorvoegsel nsvan de XML-naamruimte geïmporteerd. Vervolgens wordt het voorvoegsel van de naamruimte gebruikt om een letterlijke XML-waarde te maken en toegang te krijgen tot het eerste onderliggende knooppunt met de gekwalificeerde naam ns:name.

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

Met deze code wordt de volgende tekst weergegeven:

Patrick Hines

Zie ook