Referencias y la instrucción Imports
Actualización: noviembre 2007
Para que el proyecto pueda disponer de objetos externos, seleccione 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 que éstas.
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 dentro del código para referirse a un espacio de nombres importado. Namespace es un espacio de nombres 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.
.gif "Nota") Nota: |
|---|
No hay que confundir las referencias de proyecto con las instrucciones Imports o Declare. Las referencias de proyecto ponen los objetos externos, como los objetos de ensamblados, a disposición de 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 Módulo ControlChars (Visual Basic) 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 Microsoft.VisualBasic.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 en Visual Studio (Visual Basic)
Cómo: Crear y utilizar ensamblados
Conceptos
Espacios de nombres en Visual Basic
Referencia
Instrucción Imports (Tipo y espacio de nombres de .NET)
Módulo ControlChars (Visual Basic)