Compartilhar via

Instrução Imports (Namespace e Tipo do .NET)

Permite que os nomes de tipo sejam referenciados sem a qualificação do namespace.

Sintaxe

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

Partes

Prazo Definição
aliasname Opcional. Um alias ou nome de importação pelo qual o código pode se referir namespace em vez da cadeia de caracteres de qualificação completa. Consulte nomes de elementos declarados.
namespace Obrigatório O nome totalmente qualificado do namespace que está sendo importado. Pode ser uma cadeia de caracteres de namespaces aninhada em qualquer nível.
element Opcional. O nome de um elemento de programação declarado no namespace. Pode ser qualquer elemento de contêiner.

Observações

A Imports instrução permite que os tipos contidos em um determinado namespace sejam referenciados diretamente.

Você pode fornecer um único nome de namespace ou uma cadeia de caracteres de namespaces aninhados. Cada namespace aninhado é separado do próximo namespace de nível superior por um período (.), como ilustra o exemplo a seguir:

Imports System.Collections.Generic

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

Você só pode usar Imports no nível do arquivo. Isso significa que o contexto de declaração para importação deve ser um arquivo de origem e não pode ser um namespace, classe, estrutura, módulo, interface, procedimento ou bloco.

Observe que a Imports instrução não disponibiliza elementos de outros projetos e assemblies para seu projeto. A importação não assume o lugar de definir uma referência. Ele só remove a necessidade de qualificar nomes que já estão disponíveis para seu projeto. Para obter mais informações, consulte "Importando elementos que contêm" em referências a elementos declarados.

Observação

Você pode definir instruções implícitas Imports usando a página Referências, Designer de Projeto (Visual Basic). Para obter mais informações, consulte Como adicionar ou remover namespaces importados (Visual Basic).

Importar aliases

Um alias de importação define o alias para um namespace ou tipo. Os aliases de importação são úteis quando você precisa usar itens com o mesmo nome que são declarados em um ou mais namespaces. Para obter mais informações e um exemplo, consulte "Qualificando um nome de elemento" em referências a elementos declarados.

Você não deve declarar um membro no nível do módulo com o mesmo nome que aliasname. Se você fizer isso, o compilador do Visual Basic usará aliasname apenas para o membro declarado e não o reconhecerá mais como um alias de importação.

Embora a sintaxe usada para declarar um alias de importação seja como a usada para importar um prefixo de namespace XML, os resultados são diferentes. Um alias de importação pode ser usado como uma expressão em seu código, enquanto um prefixo de namespace XML pode ser usado apenas em literais XML ou propriedades do eixo XML como o prefixo para um elemento qualificado ou nome de atributo.

Nomes de elementos

Se você fornecer element, ele deverá representar um elemento de contêiner, ou seja, um elemento de programação que possa conter outros elementos. Os elementos de contêiner incluem classes, estruturas, módulos, interfaces e enumerações.

O escopo dos elementos disponibilizados por uma instrução Imports depende de você especificar element. Se você especificar apenas namespace, todos os membros nomeados exclusivamente desse namespace e membros de elementos de contêiner dentro desse namespace estarão disponíveis sem qualificação. Se você especificar ambos namespace e elementapenas os membros desse elemento estiverem disponíveis sem qualificação.

Exemplo 1

O exemplo a seguir retorna todas as pastas no diretório C:\ usando a DirectoryInfo classe:

O código não tem instruções Imports na parte superior do arquivo. Portanto, as referências e CrLf as DirectoryInfoStringBuilderreferências são totalmente qualificadas com os namespaces.

Public Function GetFolders() As String
    ' Create a new StringBuilder, which is used
    ' to efficiently build strings.
    Dim sb As New System.Text.StringBuilder

    Dim dInfo As New System.IO.DirectoryInfo("c:\")

    ' Obtain an array of directories, and iterate through
    ' the array.
    For Each dir As System.IO.DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(Microsoft.VisualBasic.ControlChars.CrLf)
    Next

    Return sb.ToString
End Function

Exemplo 2

O exemplo a seguir inclui Imports instruções para os namespaces referenciados. Portanto, os tipos não precisam ser totalmente qualificados com os namespaces.

' Place Imports statements at the top of your program.
Imports System.Text
Imports System.IO
Imports Microsoft.VisualBasic.ControlChars

Public Function GetFolders() As String
    Dim sb As New StringBuilder

    Dim dInfo As New DirectoryInfo("c:\")
    For Each dir As DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(CrLf)
    Next

    Return sb.ToString
End Function

Exemplo 3

O exemplo a seguir inclui Imports instruções que criam aliases para os namespaces referenciados. Os tipos são qualificados com os aliases.

Imports systxt = System.Text
Imports sysio = System.IO
Imports ch = Microsoft.VisualBasic.ControlChars

Public Function GetFolders() As String
    Dim sb As New systxt.StringBuilder

    Dim dInfo As New sysio.DirectoryInfo("c:\")
    For Each dir As sysio.DirectoryInfo In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(ch.CrLf)
    Next

    Return sb.ToString
End Function

Exemplo 4

O exemplo a seguir inclui Imports instruções que criam aliases para os tipos referenciados. Os aliases são usados para especificar os tipos.

Imports strbld = System.Text.StringBuilder
Imports dirinf = System.IO.DirectoryInfo

Public Function GetFolders() As String
    Dim sb As New strbld

    Dim dInfo As New dirinf("c:\")
    For Each dir As dirinf In dInfo.GetDirectories()
        sb.Append(dir.Name)
        sb.Append(ControlChars.CrLf)
    Next

    Return sb.ToString
End Function

Consulte também

  • Last updated on