Declaração Imports (Tipo e Namespace .NET)

  • Artigo

Importa namespaces ou elementos de programação definidos no projeto atual ou em projetos ou assemblies referenciados.

Imports [ aliasname = ] namespace
-or-
Imports [ aliasname = ] namespace.element

Partes

  • aliasname
    Opcional.Um pseudônimo de importação ou nome pelo qual o código refere-se a namespace ao invés da cadeia de caracteres de qualificação completa.SeeNomes de Elementos Declarados.

  • namespace
    Obrigatório.O nome completamente qualificado do namespace sendo importado.Pode ser uma cadeia de caracteres de namespaces aninhados em qualquer nível.

  • element
    Opcional.O nome do elemento de programação declarado no namespace.Pode ser qualquer elemento contêiner.

Comentários

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

Você pode usar Imports apenas em nível de arquivo.Isso significa que o contexto da declaração para importação deve ser um arquivo-fonte, e não um namespace, estrutura, módulo, interface, procedimento ou bloco.

Pseudônimos Import são úteis quando você necessita usar itens como o mesmo nome que está declarado em um ou mais namespaces.Para mais informações e um exemplo, veja "Classes com o Mesmo Nome" em Resolvendo uma Referência Quando Várias Variáveis Têm o Mesmo Nome.

Observe que a declaração Imports não cria elementos a partir de outros projetos e assemblies disponíveis para seu projeto.Importar não toma o lugar de configurar uma referência.Isso apenas remove a necessidade de se qualificar nome já estão disponíveis para seu projeto.Para mais informação veja "Importing Containing Elements" in Resolvendo uma Referência Quando Várias Variáveis Têm o Mesmo Nome.

Observação:

Embora a sintaxe usada para se declarar um pseudimo Import é como aquela usada para importar um prefixo de namespace XML, os resultados são diferente.Um pseudônimo Import pode ser usado como uma expressão no seu código, ao passo que um prefixo de namespace XML pode ser usado apenas em literais XML ou propriedades de eixo XML como o prefixo para um nome habilitado ou nome de atributo.

Regras

  • Nome do Pseudônimo. Você não deve delcarar um membro a nível de módulo com o mesmo nome que aliasname.Se você o fizer, o compilador do Visual Basic utiliza aliasname apenas para o membro declarado e não o reconhece mais como um pseudônimo import.

  • Nome do Namespace. Você pode fornecer um único nome de namespace ou uma cadeia de caracteres de namespaces aninhados.Cada namespace aninhado é separado do namespace do nível imediatamente mais alto por um ponto final (.), como o exemplo a seguir ilustra.

    Imports System.Collections.Generic

  • Tipo de Elemento. Se você fornecer element, ele deve representar um elemento contêiner, ou seja, um elemento de programação que contém outros elementos.Elementos contêiner incluem classes, estruturas, módulos, interfaces e enumerações.

Comportamento

  • Escopo. O escopo dos elementos feitos disponíveis por uma declaração Imports depende de você especificar element ou não.Se você especificar apenas namespace, todos os membros nomeados univocamente daquele namespace e os elementos contêiner dentro daquele namespace estão disponíveis sem habilitação.Se você especificar ambos namespace e element, apenas os membros daquele elemento estão disponíveis sem habilitação.

  • Qualificação Código fora de um namespace ou elemento contêiner deve normalmente habilitar um nome de um membro como o nome daquele namespace do elemento contêiner.A declaração Imports faz tal habilitação desnecessária, a não ser que seu projeto tenha qcesso a outro membro com o mesmo nome.Em tal caso você pode um aliasname em cada declaração Imports.Então você precisa apenas dos pseudônimos import para habilitar os membrso com o mesmo nome.

Exemplo

O exemplo a seguir importa a classe Microsoft.VisualBasic.Strings e designa um pseudônimo, str, que pode ser usado para acessar o método Left.

' Place Imports statements at the top of your program.
Imports str = Microsoft.VisualBasic.Strings

Class testClass1
    Sub showHello()
        ' Display only the word "Hello"
        MsgBox(str.Left("Hello World", 5))
    End Sub
End Class

Observe que o exemplo precedente importa um namespace aninhado, Strings dentro de VisualBasic dentro de Microsoft.Quando o Função MsgBox (Visual Basic) acessa o método Left, ele pode usar o pseudônimo str ao invés de toda a cadeia de caracteres Microsoft.VisualBasic.Strings de habilitação.

Consulte também

Conceitos

Introdução ao Class Library do Visual Studio .NET Framework

Namespaces in Visual Basic

Referência

Declaração de namespace

Instrução Imports (Namespace XML)

Outros recursos

Visual Basic e o .NET Framework