/reference
更新:2007 年 11 月
导入元数据。
/reference:file[;file2]
参数
- file, file2
一个或多个包含程序集清单的文件。若要导入多个文件,请用逗号或分号分隔文件名。
备注
/reference 选项指示编译器使指定文件中的公共类型信息对于当前正在编译的项目可用。
引用的文件必须是程序集。例如,引用的文件必须用 Visual C#、JScript 或 Visual Basic 中的 /target:library 编译器选项创建,或者用 Visual C++ 中的 /clr /LD 编译器选项创建。
/reference 不能将模块作为输入。
如果引用一个程序集(程序集 A),而其本身又引用另一个程序集(程序集 B),则在下列情况下您需要引用程序集 B:
使用来自程序集 A 的类型继承自程序集 B 中的类型或实现程序集 B 中的接口。
如果调用程序集 B 中具有返回类型或参数类型的字段、属性、事件或方法。
使用 /lib 指定一个或多个程序集引用所在的目录。
为了让编译器识别出程序集中的类型(而不是模块),需要强制解析类型,例如可以通过定义此类型的实例来完成。也有其他方法来为编译器解析程序集中的类型名称,例如,如果从一个程序集的类型继承,编译器就会知道此类型名称。
/r 是 /reference 的缩写形式。
说明: |
---|
JScript 编译器 jsc.exe 可引用使用编译器的同一版本或较早版本创建的程序集。但是,JScript 编译器在引用用编译器的较高版本创建的程序集时,可能会遇到编译错误。例如,JScript .NET 2003 编译器可引用用 JScript .NET 2002 编译器创建的任何程序集,但 JScript .NET 2002 编译器在引用用 JScript .NET 2003 创建的程序集时可能失败。 |
示例
编译源文件 input.js 并从 metad1.dll 和 metad2.dll 导入元数据以生成 out.exe:
jsc /reference:metad1.dll;metad2.dll /out:out.exe input.js