專案參考

發行項
08/21/2008

更新：2007 年 11 月

若要寫入外部元件的程式碼，您的專案必須先包含這個元件的參考。您可以建立下列元件類型的參考：

.NET Framework 類別庫或組件
COM 元件
同一方案中專案的其他組件或類別庫
XML Web Service

如需關於 XML Web Service 參考的詳細資訊，請參閱 Visual Studio 中的 Web 參考。

Visual Basic 注意事項：
在 Visual Studio 之中專案參考的管理和 Visual Basic 6.0 有所不同。如需詳細資訊，請參閱 Visual Basic 6.0 使用者可用的專案管理。

在設計階段加入參考

使用加入參考對話方塊在設計階段加入元件的參考。

[加入參考] 對話方塊會列出下列位置中的組件：

Public Assemblies 資料夾 (Program Files\Microsoft Visual Studio 9.0\Common7\IDE\Public Assemblies)。

如果您將其他組件複製到 [Public Assemblies] 資料夾，它們將會顯示在 [加入參考] 對話方塊的清單中。
您透過設定參考路徑所指定的資料夾。

設定 Visual C# 專案之參考路徑的程序稍有不同。在 Visual Basic 專案中，按一下 [參考路徑] 按鈕，以顯示 [加入參考] 對話方塊。在 Visual C# 專案中，請使用 [專案設計工具] 的專案設計工具、參考路徑頁 (C#)。如需詳細資訊，請參閱 HOW TO：設定參考路徑 (C#)。

您也可以使用 [加入參考] 對話方塊瀏覽未列出的組件。您無法從全域組件快取 (GAC) 加入參考，因為受限於它是執行階段環境的一部分。

當在專案中建立組件的參考時，Visual Studio 會在下列位置中搜尋組件：

目前專案目錄 (您可以使用 [瀏覽] 索引標籤尋找這些組件)。
同一方案中的其他專案目錄 (您可以使用 [專案] 索引標籤尋找這些組件)。
Public Assemblies 資料夾：Program Files\Microsoft Visual Studio 9.0\Common7\IDE\Public Assemblies (您可以在 [.NET] 索引標籤上找到這些組件)。
您透過設定參考路徑所指定的資料夾。(您可以使用參考路徑對話方塊 (Visual Basic) 或專案設計工具、參考路徑頁 (C#) 以設定參考路徑)。

如需在設計階段加入參考的詳細資訊，請參閱 HOW TO：在 Visual Studio 中新增或移除參考 (Visual Basic)。

在執行階段參考共用元件

在執行階段，元件必須位於專案的輸出路徑或在全域組件快取 (GAC) 中。如果專案中包含不在這些位置的物件參考，則當建置專案時，您必須將參考複製到專案的輸出路徑。CopyLocal 屬性會指出是否必須複製。如果值為 True，在建置專案時會將參考複製到專案目錄。如果值為 False，就不會複製參考。

如果您部署的應用程式中包含在 GAC 中已註冊之自訂元件的參考，則不論 CopyLocal 設定為何，該元件都不會隨著應用程式一起部署。在舊版的 Visual Studio 中，您可以在參考上設定 CopyLocal 屬性，以確保組件會進行部署。現在，您必須以手動方式將組件加入至 [\Bin] 資料夾。這麼做才會檢查所有的自訂程式碼，降低不熟悉的自訂程式碼在發行時的風險。

根據預設，如果組件或元件位於全域組件快取中或是架構元件，就會將 CopyLocal 屬性設定為 [False]。否則，便會將值設定為 [True]。專案對專案間的參考一定都會設定為 [True]。

專案對專案間的參考和檔案參考

檔案參考是指直接參考組件，您可以使用 [加入參考] 對話方塊的 [瀏覽] 索引標籤來建立檔案參考。專案對專案間的參考是指參考內含組件的專案，您可以使用 [加入參考] 對話方塊的 [專案] 索引標籤來建立專案對專案間的參考。

專案對專案間的參考之優勢在於，會在建置系統中建立專案之間的相依性。因此，如果在上次建置參考專案後專案經過變更，就會建立相依專案 (Dependent Project)。檔案參考並不會建立建置相依性，因此可能會建置參考專案而不會建置相依專案，而且參考也會過時 (也就是說，專案可以參考先前建置的專案版本)。如此將導致在 bin 目錄中需要單一 DLL 的數個版本，但這是不可能的。當發生這種衝突時，您將會看到如警告: 無法將專案 'project' 中的相依性 'file' 複製至執行目錄，因為它會覆寫參考 'file' 的訊息。

您應該避免將檔案參考加入至同一方案中的其他專案輸出，因為這麼做可能會造成編譯錯誤。請改用 [加入參考] 對話方塊中的 [專案] 索引標籤，建立同一方案中專案對專案間的參考。這樣一來就能夠對在專案中建立的類別庫進行較佳的管理，使得小組開發更為容易。如需詳細資訊，請參閱中斷參考的疑難排解和 HOW TO：建立和移除專案相依性。

Web 參考

您也可使用 [加入 Web 參考] 對話方塊以加入 Web 參考。如需詳細資訊，請參閱 HOW TO：加入和移除 Web 參考。

請參閱

共用方式為