Referencias y la instrucción Imports (Visual Basic)

  • Artículo

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 con más información.

La instrucción Imports

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

La instrucción Imports utiliza 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, mediante una definición dentro del proyecto o con una instrucción Imports anterior.

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

Nota

No confunda las referencias de proyecto con la instrucción Imports o con la Declare. 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 instrucción Imports se usa para simplificar el acceso a las referencias de proyecto, pero no proporciona acceso a estos objetos. La instrucción Declare 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 instrucción Imports facilita el acceso a métodos de clases mediante la eliminación de 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 de retorno de carro o avance de línea que hace que una sola parte del texto se muestre en varias líneas forma parte del módulo ControlChars en el espacio de nombres Microsoft.VisualBasic. 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")

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

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 instrucción Imports no incluye un nombre de alias, los elementos definidos en el espacio de nombres importado se pueden usar en el módulo sin cualificación. Si se especifica el nombre del alias, se debe usar como calificador para los nombres contenidos en ese espacio de nombres.

Consulte también