/reference

更新：2007 年 11 月

匯入中繼資料 (Metadata)。

 /reference:file[;file2]

引數

• file, file2
  包含組件資訊清單的一或多個檔案。若要匯入一個以上檔案，請以逗號或分號區隔檔案名稱。

備註

/reference 選項讓編譯器公開在指定檔案中的型別資訊，以供您正在編譯的專案使用。

您參考的檔案必須是組件。例如，所參考的檔案必須是由 Visual C#、JScript 或 Visual Basic 加上 /target:library 編譯器參數所建立，或由 Visual C++ 加上 /clr /LD 編譯器參數所建立。

/reference 不能用模組做為輸入。

如果您參考的組件 (A 組件) 本身也要參考其他組件 (B 組件) 的話，在下列情況中您必須參考 B 組件：

• 您從 A 組件使用的型別繼承自某個型別，或是從 B 組件實作介面

• 如果您從 B 組件叫用具有傳回型別或參數型別的欄位、屬性 (Property)、事件或方法

請使用 /lib 指定一或多個組件參考所在的目錄。

如果要讓編譯器辨認組件 (而非模組) 中的某個型別，就必須強制它解析這個型別，您可以藉由定義該型別的執行個體來進行這種強制解析。還有其他方法可以為編譯器解析決組件中的型別名稱，例如，如果您是從組件中的型別繼承，編譯器隨後即可得知型別名稱。

/r 是 /reference 的簡短形式。

注意事項：
JScript 編譯器 jsc.exe 可以參考使用相同版本或舊版編譯器所建立的組件。但是，若是參考新版編譯器所建立的組件，則 JScript 編譯器可能會發生編譯時期錯誤。例如，JScript .NET 2003 編譯器可參考任何 JScript .NET 2002 編譯器所建立的組件，不過，JScript .NET 2002 編譯器可能會因參考 JScript .NET 2003 編譯器所建立的組件而失敗。

範例

編譯 input.js 原始程式檔 (Source File)，並從 metad1.dll 和 metad2.dll 匯入中繼資料以產生 out.exe：

jsc /reference:metad1.dll;metad2.dll /out:out.exe input.js

請參閱

其他資源

JScript 編譯器選項