Compartir a través de

Referencias y la instrucción Imports (Visual Basic)

Para que los objetos externos estén disponibles para el proyecto, elija el comando Agregar referencia en el menú Proyecto . Las referencias de Visual Basic pueden apuntar a ensamblados, que son como bibliotecas de tipos, pero contienen más información.

Instrucción Imports

Los ensamblados incluyen uno o varios espacios de nombres. Al agregar una referencia a un ensamblado, también puede agregar una Imports instrucción a un módulo que controla la visibilidad de los espacios de nombres de ese ensamblado dentro del módulo. La Imports instrucción proporciona un contexto de ámbito que permite usar solo la parte del espacio de nombres necesario para proporcionar una referencia única.

La instrucción Imports tiene la sintaxis siguiente:

Imports [Aliasname =] Namespace

Aliasname hace referencia a un nombre corto que puede usar en el código para hacer referencia a un espacio de nombres importado. Namespace es un espacio de nombres disponible a través de una referencia de proyecto, a través de una definición dentro del proyecto o a través de una instrucción anterior Imports .

Un módulo puede contener cualquier número de Imports instrucciones. Deben aparecer después de cualquier Option instrucción, si está presente, pero antes de cualquier otro código.

Nota:

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

Uso de alias con la instrucción Imports

La Imports instrucción facilita el acceso a métodos de clases eliminando la necesidad de escribir explícitamente los nombres completos de referencias. Los alias permiten asignar un nombre más descriptivo a solo una parte de un espacio de nombres. Por ejemplo, la secuencia de retorno y avance de línea de carro que hace que se muestre una sola parte de texto en varias líneas forma parte del ControlChars módulo en el Microsoft.VisualBasic espacio de nombres. Para usar esta constante en un programa sin un alias, tendría que escribir el código siguiente:

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

Imports Las instrucciones siempre deben ser las primeras líneas inmediatamente después de las Option instrucciones de un módulo. El fragmento de código siguiente muestra cómo importar y asignar un alias al Microsoft.VisualBasic.ControlChars módulo:

Imports CtrlChrs = Microsoft.VisualBasic.ControlChars

Las referencias futuras a este espacio de nombres pueden ser considerablemente más cortas:

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

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

Consulte también