Compartir a través de


Referencias y la instrucción Imports (Visual Basic)

Para que el proyecto pueda disponer de objetos externos, elija el comando Agregar referencia del menú Proyecto. Las referencias en Visual Basic pueden apuntar a ensamblados, que son similares a las bibliotecas de tipos pero contienen más información.

Instrucción Imports

Los ensamblados incluyen uno o varios espacios de nombres. Cuando se agrega una referencia a un ensamblado, también puede agregarse una instrucción Imports a un módulo para controlar la visibilidad de los espacios de nombres del ensamblado dentro del módulo. La instrucción Imports proporciona un contexto de control de ámbito que permite utilizar solamente la parte del espacio de nombres necesaria para suministrar una referencia única.

La instrucción Imports tiene la siguiente sintaxis:

Imports [| Aliasname =] Namespace

Aliasname hace referencia a un nombre corto que se puede utilizar en el código para referirse a un espacio de nombres importado. Namespace es un espacio de nombres que está disponible mediante una referencia de proyecto, una definición dentro del proyecto o una instrucción Imports anterior.

Un módulo puede contener cualquier número de instrucciones Imports. Éstas deben aparecer detrás de las instrucciones Option, si hay alguna, pero antes de cualquier otro código.

NotaNota

No hay que confundir las referencias de proyecto con las instrucciones Imports o Declare.Las referencias de proyecto hacen que los objetos externos, como los objetos de ensamblados, estén disponibles para los proyectos de Visual Basic.La instrucción Imports se utiliza para simplificar el acceso a las referencias de proyecto, pero no facilita el acceso a dichos objetos.La instrucción Declare se utiliza para declarar una referencia a un procedimiento externo de una biblioteca de vínculos dinámicos (DLL).

Utilizar alias con la instrucción Imports

La instrucción Imports facilita el acceso a los métodos de clases porque elimina la necesidad de escribir explícitamente los nombres completos de las referencias. Los alias permiten asignar un nombre más descriptivo a una sola parte de un espacio de nombres. Por ejemplo, la secuencia retorno de carro y avance de línea, que permite mostrar un texto en varias líneas, forma parte del módulo ControlChars del espacio de nombres Microsoft.VisualBasic. Para utilizar esta constante en un programa que no tenga un alias, debe escribir el siguiente fragmento de código:

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

Las instrucciones Imports deben aparecer siempre en las primeras líneas, inmediatamente después de cualquier instrucción Option de un módulo. El fragmento de código siguiente muestra cómo se importa y se asigna un alias al módulo ControlChars:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Las referencias que después se hagan a este espacio de nombres pueden ser mucho más breves:

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

Si una instrucción Imports no incluye un nombre de alias, los elementos definidos en el espacio de nombres importado pueden utilizarse en el módulo sin calificación. Si se especifica el nombre del alias, debe utilizarse como calificador de los nombres contenidos en dicho espacio de nombres.

Vea también

Tareas

Cómo: Agregar o quitar referencias utilizando el cuadro de diálogo Agregar referencia

Cómo: Crear y utilizar ensamblados desde la línea de comandos (C# y Visual Basic)

Referencia

Instrucción Imports (Tipo y espacio de nombres de .NET)

ControlChars

Microsoft.VisualBasic

Conceptos

Espacios de nombres en Visual Basic

Ensamblados y caché global de ensamblados (C# y Visual Basic)