Compartilhar via

Instrução Imports (Namespace XML)

Importa prefixos de namespace XML para uso em literais XML e propriedades do eixo XML.

Sintaxe

Imports <xmlns:xmlNamespacePrefix = "xmlNamespaceName">

Partes

xmlNamespacePrefix
Opcional. A cadeia de caracteres à qual elementos XML e atributos podem se referir xmlNamespaceName. Se não xmlNamespacePrefix for fornecido, o namespace XML importado será o namespace XML padrão. Deve ser um identificador XML válido. Para obter mais informações, consulte nomes de elementos e atributos XML declarados.

xmlNamespaceName
Obrigatório A cadeia de caracteres que identifica o namespace XML que está sendo importado.

Observações

Você pode usar a Imports instrução para definir namespaces XML globais que podem ser usados com literais XML e propriedades do eixo XML ou como parâmetros passados para o GetXmlNamespace operador. (Para obter informações sobre como usar a Imports instrução para importar um alias que pode ser usado onde os nomes de tipo são usados em seu código, consulte a Instrução Imports (Namespace e Tipo do .NET).) A sintaxe para declarar um namespace XML usando a Imports instrução é idêntica à sintaxe usada em XML. Portanto, você pode copiar uma declaração de namespace de um arquivo XML e usá-la em uma instrução Imports .

Prefixos de namespace XML são úteis quando você deseja criar repetidamente elementos XML que são do mesmo namespace. O prefixo de namespace XML declarado com a Imports instrução é global no sentido de que ele está disponível para todo o código no arquivo. Você pode usá-lo quando cria literais de elemento XML e quando acessa as propriedades do eixo XML. Para obter mais informações, consulte Propriedades do eixo literal e XML do elemento XML.

Se você definir um namespace XML global sem um prefixo de namespace (por exemplo, Imports <xmlns="http://SomeNameSpace>"), esse namespace será considerado o namespace XML padrão. O namespace XML padrão é usado para literais de elemento XML ou propriedades do eixo de atributo XML que não especificam explicitamente um namespace. O namespace padrão também será usado se o namespace especificado for o namespace vazio (ou seja, xmlns=""). O namespace XML padrão não se aplica a atributos XML em literais XML ou a propriedades do eixo de atributo XML que não têm um namespace.

Namespaces XML definidos em um literal XML, que são chamados de namespaces XML locais, têm precedência sobre namespaces XML definidos pela instrução Imports como globais. Os namespaces XML definidos pela instrução Imports têm precedência sobre namespaces XML importados para um projeto do Visual Basic. Se um literal XML definir um namespace XML, esse namespace local não se aplicará a expressões inseridas.

Os namespaces XML globais seguem as mesmas regras de escopo e definição que os namespaces do .NET Framework. Como resultado, você pode incluir uma instrução Imports para definir um namespace XML global em qualquer lugar em que possa importar um namespace do .NET Framework. Isso inclui arquivos de código e namespaces importados no nível do projeto. Para obter informações sobre namespaces importados no nível do projeto, consulte a página Referências, Designer de Projeto (Visual Basic).

Cada arquivo de origem pode conter qualquer número de Imports instruções. Elas devem seguir declarações de opção, como a Option Strict instrução, e devem preceder declarações de elemento de programação, como Module ou Class instruções.

Exemplo 1

O exemplo a seguir importa um namespace XML padrão e um namespace XML identificado com o prefixo ns. Em seguida, ele cria literais XML que usam ambos os namespaces.

' 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

Este código exibe o seguinte texto:

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

Exemplo 2

O exemplo a seguir importa o prefixo nsdo namespace XML. Em seguida, ele cria um literal XML que usa o prefixo do namespace e exibe o formulário final do elemento.

' 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

Este código exibe o seguinte texto:

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

Observe que o compilador converteu o prefixo de namespace XML de um prefixo global em uma definição de prefixo local.

Exemplo 3

O exemplo a seguir importa o prefixo nsdo namespace XML. Em seguida, ele usa o prefixo do namespace para criar um literal XML e acessar o primeiro nó filho com o nome ns:namequalificado.

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

Este código exibe o seguinte texto:

Patrick Hines

Consulte também

  • Last updated on