專案參考

  • 發行項

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

  • .NET Framework 類別庫或組件

  • COM 元件

  • 同一方案中專案的其他組件或類別庫

  • XML Web Service

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

在設計階段加入參考

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

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

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

  • 目前專案目錄 (您可以使用 [瀏覽] 索引標籤尋找這些組件)。

  • 同一方案中的其他專案目錄 (您可以使用 [專案] 索引標籤尋找這些組件)。

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

注意事項注意事項

所有專案都包含 mscorlib 的隱含參考。 Visual Basic 專案包含 Microsoft.VisualBasic 的隱含參考。

在 Visual Studio 2010 中，所有專案都包含 System.Core 的隱含參考，即使 System.Core 已從參考清單中移除也一樣。

在執行階段參考共用元件

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

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

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

參考目標為不同 .NET Framework 版本的專案或組件

您可以建立參考目標為不同 .NET Framework 版本之專案或組件的應用程式。 例如，您可以建立目標為 .NET Framework 4 Client Profile (參考目標為 .NET Framework 2.0 版 的組件) 的應用程式。 如果您建立之專案的目標是舊版 .NET Framework，則無法在該專案中設定目標為 .NET Framework 4 Client Profile 或 .NET Framework 第 4 版之專案或組件的參考。

如需詳細資訊，請參閱 以特定的 .NET Framework 版本或設定檔為目標。

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

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

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

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

注意事項注意事項

在 Visual Studio 2010 中，如果某個專案的 .NET Framework 目標版本為第 4 版，而其他專案的目標版本為第 2 版、第 3 版或 3.5 版，則會建立檔案參考而非專案參考。

Web 參考

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

請參閱

工作

中斷參考的疑難排解

HOW TO：在 Visual Studio 中新增或移除參考

其他資源

參考命名空間和元件

管理參考

使用組件設計程式