Referências e a declaração Imports (Visual Basic)
Você pode tornar externos objetos disponíveis para o projeto escolhendo o comando Adicionar Referência no menu Projeto.Referências em Visual Basic podem apontar para conjuntos de módulos (assemblies), que são como bibliotecas mas contêm mais informações.
A declaração Imports
Conjuntos de Módulos (Assemblies) incluem um ou mais NameSpaces.Quando você adiciona uma referência a um conjunto de módulos (assembly), você também pode adicionar uma instrução Imports em um módulo que controla a visibilidade dos namespaces daquele assembly dentro do módulo.A instrução Imports fornece um contexto de escopo que permite que você use apenas a parte do namespace necessária para fornecer uma referência única.
A instrução Imports possui a seguinte sintaxe:
Imports [|Aliasname =] Namespace
Aliasnamerefere-se para um nome curto, que você pode usar para se referir a um namespace importado dentro do código.Namespaceé uma referência de projeto, por meio de uma definição de dentro do projeto ou um anterior de um espaço para nome disponível por meio de um Imports instrução.
Um módulo pode conter qualquer número de instruções Imports .Elas devem aparecer após quaisquer instruções Option, se alguma estiver presente, mas antes de qualquer outro código.
.gif "Observação") Observação |
|---|
Não confunda referências de projeto com a instrução Imports ou a instrução Declare.Referências de projeto tornam objetos externos, como objetos de conjuntos de módulos (assemblies), disponíveis para projetos Visual Basic.A instrução Imports é usada para simplificar o acesso às referências de projeto, mas não fornece acesso a esses objetos.A instrução Declare é usada para declarar uma referência a um procedimento externo em uma biblioteca de vínculo dinâmico (DLL). |
Usando aliases com a instrução Imports
A instrução Imports facilita o acesso a métodos de classes, eliminando a necessidade para digitar explicitamente os nomes totalmente qualificados das referências.Os aliases permitem que você atribua um nome amigável a apenas uma parte de um namespace.Por exemplo, a sequência retorno de carro/linha alimentação que faz com que um único seguimento de texto seja exibido em várias linhas é parte do módulo ControlChars no namespace Microsoft.VisualBasic.Para usar essa constante em um programa sem um alias, você precisará digitar o seguinte código:
MsgBox("Some text" & Microsoft.VisualBasic.ControlChars.CrLf &
"Some more text")
As instruções Imports devem sempre ser as primeiras linhas imediatamente após quaisquer instruções Option em um módulo.O fragmento de código a seguir mostra como importar e atribuir um alias ao módulo Microsoft.VisualBasic.ControlChars:
Imports CtrlChrs = Microsoft.VisualBasic.ControlChars
Referências futuras a esse namespace podem ser consideravelmente menores:
MsgBox("Some text" & CtrlChrs.CrLf & "Some more text")
Se uma instrução Imports não incluir um nome de alias, elementos definidos no namespace importado podem ser usados no módulo sem qualificação.Se o nome do alias for especificado, ele deve ser usado como um qualificador para os nomes contidos naquele namespace.
Consulte também
Tarefas
Como: Adicionar ou remover referências usando a caixa de diálogo Adicionar referência
Como: criar e usar Assemblies usando a linha de comando (C# e Visual Basic)
Referência
Importa instrução (.NET espaço para nome e tipo)
Conceitos
Assemblies e o Cache Global de assemblies (C# e Visual Basic)