Referências e o statement Imports
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
Aliasname refere-se a um pequeno nome que você possa dentro do código para se referir a um namespace importado. Namespace é um espaço para nome disponível por meio de uma referência de projeto, por meio de uma definição de dentro do projeto ou por meio de uma anterior Imports demonstrativo.
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 o Imports demonstrativo ou o Declare demonstrativo. 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 Módulo ControlChars (Visual Basic) 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 no Visual Studio (Visual Basic)
Conceitos
Conjuntos de Módulos (Assemblies)
Referência
Declaração Imports (Tipo e Namespace .NET)
Módulo ControlChars (Visual Basic)