/reference
Importa metadatos.
/reference:file[;file2]
Argumentos
- file, file2
Uno o varios archivos que contienen un manifiesto de ensamblado. Para importar más de un archivo, hay que separar los nombres de archivo con comas o puntos y comas.
Comentarios
La opción /reference hace que el compilador facilite la información pública de tipos presente en los archivos especificados al proyecto que se compila actualmente.
El archivo o archivos a los que se hace referencia deben ser ensamblados. Por ejemplo, los archivos a los que se hace referencia deben haberse creado con la opción de compilador /target:library en Visual C#, JScript o Visual Basic, o las opciones de compilador /clr /LD de Visual C++.
/reference no puede tener un módulo como entrada.
Si se hace referencia a un ensamblado (Ensamblado A) que, a su vez, hace referencia a otro ensamblado (Ensamblado B), se deberá hacer referencia al ensamblado B si:
Un tipo utilizado en el Ensamblado A hereda de un tipo o implementa una interfaz del Ensamblado B.
Si se invoca un campo, una propiedad, un evento o un método que devuelve un tipo o tiene un tipo de parámetro de Ensamblado B.
Utilice /lib para especificar el directorio en el que se encuentran una o varias de las referencias de ensamblados.
Para que el compilador reconozca un tipo en un ensamblado (no en un módulo), debe obligársele a que resuelva el tipo, lo que se puede conseguir, por ejemplo, definiendo una instancia del tipo. Existen otras formas de que el compilador resuelva nombres de tipos en un ensamblado; por ejemplo, si se hereda de un tipo de un ensamblado, el compilador reconocerá el nombre del tipo.
La opción /r es la forma corta de /reference.
Nota
El compilador de JScript, jsc.exe, puede hacer referencia a ensamblados creados mediante la misma versión del compilador o una versión anterior. No obstante, el compilador de JScript puede sufrir errores en tiempo de compilación al hacer referencia a ensamblados creados con versiones posteriores del compilador. Por ejemplo, el compilador de JScript .NET 2003 puede hacer referencia a cualquier ensamblado creado con el compilador de JScript .NET 2002, aunque se puede producir un error si este compilador hace referencia a un ensamblado creado con JScript .NET 2003.
Ejemplo
Para compilar el archivo de código fuente input.js e importar metadatos de metad1.dll y metad2.dll con el fin de generar out.exe, ejecute:
jsc /reference:metad1.dll;metad2.dll /out:out.exe input.js