管理專案參考

發行項
02/28/2013

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

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

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

在設計階段加入參考

若要加入一或多個參考在設計階段，您可以使用 [參考管理員] 對話方塊或 [加入參考] 對話方塊中，專案類型建置。您提供任何 Windows 市集應用程式和專案的大部分其他型別使用參考管理員對話方塊。如需詳細資訊，請參閱HOW TO：使用參考管理員新增或移除參考。其他專案類型支援 [加入參考] 對話方塊。如需詳細資訊，請參閱HOW TO：使用加入參考對話方塊加入或移除參考。

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

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

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

如需在設計階段加入參考的詳細資訊，請參閱 HOW TO：使用加入參考對話方塊加入或移除參考。

注意事項
所有專案都包含 mscorlib 的隱含參考。Visual Basic 專案包含 Microsoft.VisualBasic 的隱含參考。在 Visual Studio 的所有專案中包含 System.Core中的隱含參考，即使， System.Core 會參考清單中移除。

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

在 Visual Studio 的所有專案中包含 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：建立和移除專案相依性。

注意事項
而非專案參考的檔案參考建立，如果專案 .NET Framework 的目標版本是版本 4.5，，而另一個專案的目標版本是版本 2， 3， 3.5 或 4.0。

Web 參考

您也可使用 [加入 Web 參考] 對話方塊以加入 Web 參考。如需詳細資訊，請參閱How to: Add and Remove Web References。

請參閱