# /reference (C# Compiler Options) **/reference** 選項導致編譯器將指定文件中的 [公開](https://msdn.microsoft.com/zh-cn/library/yzh058ae.aspx) 類型信息導入到當前項目中，從而使您可以從指定的程序集文件引用元數據。 ## 語法 ``` /reference:[alias=]filename /reference:filename ``` ## 參數 _filename_ 包含程序集清單的文件的名稱。若要導入多個文件，請為每個文件包括一個單獨的 **/reference** 選項。 _alias_ 一個有效的 C# 標識符，表示將包含程序集中所有命名空間的根命名空間。 ## 備注 若要從多個文件導入，請為每個文件包括一個 **/reference** 選項。 導入的文件必須包含一個清單；輸出文件必須已使用 [/目標:模塊](https://msdn.microsoft.com/zh-cn/library/58scf68s.aspx) 以外的 [/目標](https://msdn.microsoft.com/zh-cn/library/6h25dztx.aspx) 選項之一編譯過。 **/r** 是 **/reference** 的縮寫形式。 使用 [/addmodule](https://msdn.microsoft.com/zh-cn/library/1s46f83c.aspx) 從不包含程序集清單的輸出文件導入元數據。 如果您引用了一個程序集（程序集 A），其本身又引用了另一個程序集（程序集 B），則在下列情況下需要引用程序集 B： * 使用來自程序集 A 的類型繼承自程序集 B 中的類型或實現程序集 B 中的接口。 * 調用具有程序集 B 中的返回類型或參數類型的字段、屬性、事件或方法。 使用 [/lib](https://msdn.microsoft.com/zh-cn/library/s5bac5fx.aspx) 指定一個或多個程序集引用所在的目錄。 **/lib** 主題還討論了編譯器在哪些目錄中搜索程序集。 為使編譯器可以識別程序集（而不是模塊）中的某個類型，需要強制解析此類型，這可以通過定義此類型的實例來完成。還有其他方法可為編譯器解析程序集中的類型名稱：例如，如果您從程序集中的類型繼承，編譯器就能識別類型名稱。 有時必須從一個程序集內部引用同一組件的兩個不同版本。為此，請在每個文件的 **/reference** 開關上使用 alias 子選項，以區分兩個文件。此別名將用作組件名稱的限定符，并解析為其中一個文件中的組件。 默認情況下使用 csc 響應 (.rsp) 文件，該文件引用常用的 .NET Framework 程序集。如果希望編譯器不要使用 csc.rsp，請使用 [/noconfig](https://msdn.microsoft.com/zh-cn/library/8hww4s6c.aspx)。 |  注意 | | :-- | | 在 Visual Studio 中，請使用**“添加引用”**對話框。有關更多信息，請參見[如何：使用“添加引用”對話框添加或移除引用](https://msdn.microsoft.com/zh-cn/library/wkze6zky.aspx)。在 Visual Studio 2010 和更高版本中，若要確保通過使用 **/reference** 添加引用與通過使用**“添加引用”**對話框添加引用之間的行為等效，必須將您要添加的程序集的**“嵌入互操作類型”**屬性設置為**“False”**。 **“True”**為該屬性的默認值。 | ### 示例 本示例演示如何使用[外部別名](https://msdn.microsoft.com/zh-cn/library/ms173212.aspx)功能。 編譯源文件，并從先前已編譯的 grid.dll 和 grid20.dll 中導入元數據。這兩個 DLL 包含同一組件的不同版本，您將使用兩個帶有別名選項的 **/reference** 編譯源文件。這兩個選項如下所示： /reference:GridV1=grid.dll 和 /reference:GridV2=grid20.dll 這將設置外部別名“GridV1”和“GridV2”，您將在程序中通過外部語句使用它們： ``` extern alias GridV1; extern alias GridV2; // Using statements go here. ``` 完成此操作后，您可以通過在控件名稱前添加 GridV1 前綴來引用 grid.dll 中的網格控件，如下所示： ``` GridV1::Grid ``` 此外，您可以通過在控件名稱前添加 GridV2 前綴來引用 grid20.dll 中的網格控件，如下所示： ``` GridV2::Grid ``` ## 請參閱 [C# Compiler Options](https://msdn.microsoft.com/zh-cn/library/2fdbz5xd.aspx) [如何：修改項目屬性和配置設置](https://msdn.microsoft.com/zh-cn/library/z15yzzew.aspx)