大网数据广告活动
.NET 与 C# 开发

-reference(C# 编译器选项)

· 52CE 我爱测

-reference 选项使编译器将指定文件中的公共类型信息导入当前项目,从而使你可从指定的程序集文件中引用元数据。

-reference 选项使编译器将指定文件中的公共类型信息导入当前项目,从而使你可从指定的程序集文件中引用元数据。

语法

-reference:[alias=]filename  
-reference:filename  

自变量

filename
包含程序集清单的文件的名称。 若要导入多个文件,请为每个文件包括一个单独的 -reference 选项。

alias
一个有效的 C# 标识符,表示将包含程序集中所有命名空间的根命名空间。

备注

若要从多个文件导入,请为每个文件包括一个 -reference 选项。

导入的文件必须包含一个清单;输出文件必须已使用-target:module 以外的一个 -target 选项进行了编译。

-r 是 -reference 的缩写形式。

使用 -addmodule 从不包含程序集清单的输出文件中导入元数据。

如果引用的程序集(程序集 A)引用了另一个程序集(程序集 B),那么在下列情况下需要引用程序集 B:

  • 使用程序集 A 中的类型,该类型继承自程序集 B 中的类型或实现程序集 B 中的接口。

  • 调用具有程序集 B 中的返回类型或参数类型的字段、属性、事件或方法。

使用 -lib 指定一个或多个程序集引用所在的目录。 -Lib 主题还讨论了编译器在哪些目录中搜索程序集。

为使编译器可以识别程序集(而不是模块)中的某个类型,需要强制解析此类型,这可以通过定义此类型的实例来完成。 还可通过其他方法为编译器解析程序集中的类型名称:例如,如果从程序集中继承类型,编译器就能识别类型名称。

有时,需要在一个程序集内引用同一组件的两个不同版本。 为此,请在每个文件的 -reference 开关上使用别名子选项,以区分两个文件。 此别名将用作组件名的限定符,并解析为其中一个文件中的组件。

默认情况下使用 csc 响应 (.rsp) 文件,该文件引用常用的 .NET Framework 程序集。 如果希望编译器不要使用 csc.rsp,请使用 -noconfig。

Note: 在 Visual Studio 中,请使用“添加引用”对话框。 有关详细信息,请参阅如何:使用引用管理器添加或删除引用。 若要确保通过使用 -reference 添加引用与通过使用“添加引用”对话框添加引用之间的行为等效,请将要添加的程序集的“嵌入互操作类型”属性设置为“False”。 “True”是该属性的默认值。

示例

本示例演示如何使用外部别名功能。

编译源文件,并从先前已编译的 grid.dll 和 grid20.dll 中导入元数据。 这两个 DLL 包含同一组件的不同版本,将使用两个带有别名选项的 -reference 编译源文件。 这两个选项如下所示:

-reference:GridV1=grid.dll -reference:GridV2=grid20.dll  

这将设置外部别名 GridV1 和 GridV2,将通过 extern 语句在程序中使用它们:

extern alias GridV1;  
extern alias GridV2;  
// Using statements go here.  

完成此操作后,可以通过在控件名称前添加 GridV1 前缀来引用 grid.dll 中的网格控件,如下所示:

GridV1::Grid  

此外,可以通过在控件名称前添加 GridV2 前缀来引用 grid20.dll 中的网格控件,如下所示:

GridV2::Grid   

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 07/20/2015
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。