-reference (Visual Basic)

  • Artículo

Hace que el compilador facilite al proyecto que se está compilando información de tipos en los ensamblados especificados.

Sintaxis

-reference:fileList

o

-r:fileList

Argumentos

Término Definición
fileList Obligatorio. Lista delimitada por comas de nombres de archivos de ensamblado. Si el nombre de archivo contiene un espacio, escríbalo entre comillas.

Comentarios

Los archivos que importe deben contener metadatos de ensamblado. Solo los tipos públicos son visibles fuera del ensamblado. La opción -addmodule importa metadatos de un módulo.

Si hace referencia a un ensamblado (ensamblado A) que a su vez hace referencia a otro ensamblado (ensamblado B), debe hacer referencia al ensamblado B si:

  • Un tipo del ensamblado A hereda de un tipo o implementa una interfaz del ensamblado B.

  • Se invoca a un campo, una propiedad, un evento o un método que tiene un tipo de parámetro o un tipo de valor devuelto del ensamblado B.

Use -libpath para especificar el directorio en el que se encuentran una o varias de las referencias de ensamblado.

Para que el compilador reconozca un tipo en un ensamblado (no un módulo), se debe forzar la resolución del tipo. Un ejemplo de cómo puede hacerse es definir una instancia del tipo. Existen otras formas de resolver nombres de tipo en un ensamblado para el compilador. Por ejemplo, si se hereda de un tipo de un ensamblado, nombre del tipo pasa a ser conocido para el compilador.

De forma predeterminada se usa el archivo de respuesta Vbc.rsp, que hace referencia a los ensamblados de .NET Framework usados habitualmente. Use -noconfig si no quiere que el compilador use Vbc.rsp.

La forma abreviada de -reference es -r.

Ejemplo

El comando siguiente compila el archivo de código fuente Input.vb y hace referencia a ensamblados de Metad1.dll y Metad2.dll para generar Out.exe.

vbc -reference:metad1.dll,metad2.dll -out:out.exe input.vb

Vea también