Referências e a instrução Imports (Visual Basic)

  • Artigo

Você pode disponibilizar objetos externos para seu projeto escolhendo o comando Adicionar referência no menu Projeto . Referências no Visual Basic podem apontar para assemblies, que são como bibliotecas de tipo, mas contêm mais informações.

Declaração de Importação

Os assemblies incluem um ou mais namespaces. Ao adicionar uma referência a um assembly, você também pode adicionar uma Imports instrução a um módulo que controla a visibilidade dos namespaces desse assembly dentro do módulo. A Imports instrução fornece um contexto de escopo que permite usar apenas a parte do namespace necessária para fornecer uma referência exclusiva.

A Imports instrução tem a seguinte sintaxe:

Imports [Aliasname =] Namespace

Aliasname refere-se a um nome curto que você pode usar dentro do código para se referir a um namespace importado. Namespace é um namespace disponível por meio de uma referência de projeto, por meio de uma definição dentro do projeto ou por meio de uma instrução anterior Imports .

Um módulo pode conter qualquer número de Imports instruções. Devem aparecer depois de quaisquer Option declarações, se existirem, mas antes de qualquer outro código.

Nota

Não confunda referências de projeto com a Imports instrução ou a Declare declaração. As referências de projeto disponibilizam objetos externos, como objetos em assemblies, para projetos do Visual Basic. A Imports instrução é usada para simplificar o acesso a referências de projeto, mas não fornece acesso a esses objetos. A Declare instrução é usada para declarar uma referência a um procedimento externo em uma biblioteca de vínculo dinâmico (DLL).

Usando aliases com a declaração de importação

A Imports instrução facilita o acesso a métodos de classes, eliminando a necessidade de digitar explicitamente os nomes totalmente qualificados de referências. Os aliases permitem atribuir um nome mais amigável a apenas uma parte de um namespace. Por exemplo, a sequência de retorno de carro/alimentação de linha que faz com que um único pedaço de texto seja exibido em várias linhas faz parte do ControlChars módulo no Microsoft.VisualBasic namespace. Para usar essa constante em um programa sem um alias, você precisa digitar o seguinte código:

MsgBox("Some text" & Microsoft.VisualBasic.ControlChars.CrLf &
       "Some more text")

Imports As instruções devem ser sempre as primeiras linhas imediatamente após qualquer Option instrução em um módulo. O fragmento Microsoft.VisualBasic.ControlChars de código a seguir mostra como importar e atribuir um alias ao módulo:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

As referências futuras a este namespace podem ser consideravelmente mais curtas:

MsgBox("Some text" & CtrlChrs.CrLf & "Some more text")

Se uma Imports instrução não incluir um nome de alias, os elementos definidos no namespace importado poderão ser usados no módulo sem qualificação. Se o nome do alias for especificado, ele deverá ser usado como um qualificador para nomes contidos nesse namespace.

Consulte também