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

若要在應用程式中使用元件,您必須先加入該元件的參考。 Visual Studio 在 [加入參考] 對話方塊中提供了五個選項:

  • .NET:列出所有可供參考的 .NET Framework 元件。

  • COM:列出所有可供參考的 COM 元件。

  • 專案:列出所有在本機專案中建立的可重複使用元件。

  • 瀏覽:可讓您瀏覽檔案系統中的元件。

  • 最近使用:包含最近加入電腦上專案中的元件清單。

[加入參考] 對話方塊上方的索引標籤數目會依據您開啟的專案類型及其使用的資源而有所不同。 C++ 原生專案只包含 [專案] 索引標籤。

視專案的 .NET Framework 版本而定,清單中的部分元件可能不會顯示。 在下列狀況下可能會發生這種情形:

  • 使用最近版本 .NET Framework 的元件,與目標針對舊版 .NET Framework 的專案並不相容。

    如需如何變更專案之目標 .NET Framework 版本的詳細資訊,請參閱 HOW TO:以特定的 .NET Framework 版本或設定檔為目標

  • 使用 .NET Framework 4 的元件與目標針對 .NET Framework 4 Client Profile 的專案不相容。

    當您建立新的應用程式時,有些專案預設會以 .NET Framework 4 Client Profile 為目標。 如需詳細資訊,請參閱 .NET Framework Client Profile

您無法從全域組件快取加入參考,因為受限於它是執行階段環境的一部分。

如果您部署或複製的應用程式中包含在全域組件快取中已註冊之自訂元件的參考,則不論 Copy Local 設定為何,該元件都不會隨著應用程式一起部署或複製。 如需詳細資訊,請參閱專案參考

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

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

注意事項注意事項

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

如果您要將參考加入內含內部資訊清單的已註冊 COM DLL,請確定已先移除註冊 DLL。 如果不這麼做,Visual Studio 會將組件參考新增成 ActiveX 元件,而不是原生 DLL。

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

手動加入對任何 EnvDTE 命名空間 (EnvDTEEnvDTE80EnvDTE90EnvDTE90aEnvDTE100) 的參考時,請在 [屬性] 視窗中,將參考的 Embed Interop Types 屬性設定成 False。 如果將此屬性設成 True,可能會導致組建問題,因為某些 EnvDTE 屬性是無法內嵌的。

注意事項注意事項

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

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

若要在加入參考對話方塊中顯示組件

  • 將組件移動或複製至下列其中一個位置:

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

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

    -或-

  • 設定用以指定組件顯示位置的登錄機碼:

    針對 32 位元的作業系統,請加入下列登錄機碼之一。

    • [HKEY_CURRENT_USER\SOFTWARE\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    針對 64 位元的作業系統,請在 32 位元登錄區中,加入下列登錄機碼之一。

    • [HKEY_CURRENT_USER\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    • [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\VersionMinimum\AssemblyFoldersEx\MyAssemblies]@="AssemblyLocation"

    VersionMinimum 是適用的最低 .NET Framework 版本。 如果 VersionMinimum 是 v3.0,則 AssemblyFoldersEx 中指定的資料夾適用於以 .NET Framework 3.0 (含) 以後版本為目標的專案。

    AssemblyLocation 代表您想要在 [加入參考] 對話方塊中顯示的組件目錄,例如:C:\MyAssemblies\。

    在 HKEY_LOCAL_MACHINE 節點下建立登錄機碼,可讓所有使用者都能在 [加入參考] 對話方塊中看到指定之位置中的組件。 在 HKEY_CURRENT_USER 節點下建立登錄機碼,只會影響目前使用者的設定。

    再次開啟 [加入參考] 對話方塊。 組件應該會出現在 [.NET] 索引標籤上。 如果未顯示,請確認組件位於指定的 AssemblyLocation 目錄中,然後重新啟動 Visual Studio 再試一次。

若要在 Visual Basic 中加入參考

  1. 請在 [方案總管] 中,按兩下專案的 [我的專案] 節點。

  2. 在 [專案設計工具] 中,按一下 [參考] 索引標籤。

  3. 按一下 [加入] 按鈕,以開啟 [加入參考] 對話方塊。

  4. 在 [加入參考] 對話方塊中,選取指示要參考之元件類型的索引標籤。

  5. 選取您要參考的元件,然後按一下 [確定]。

    秘訣秘訣

    假如元件都在相同的索引標籤中,您就可以按住 CTRL 鍵並選取多個元件。

在 Visual C# 中加入參考

  1. 在 [方案總管] 中,以滑鼠右鍵按一下專案節點,然後按一下 [加入參考]。

  2. 在 [加入參考] 對話方塊中,選取指示要參考之元件類型的索引標籤。

  3. 選取您要參考的元件,然後按一下 [確定]。

    秘訣秘訣

    假如元件都在相同的索引標籤中,您就可以按住 CTRL 鍵並選取多個元件。

若要在 Visual Basic 中移除參考

  1. 請在 [方案總管] 中,按兩下專案的 [我的專案] 節點。

  2. 在 [專案設計工具] 中,按一下 [參考] 索引標籤。

  3. 在 [參考] 清單中,選取您要移除的參考。

  4. 按一下 [移除] 按鈕。

    秘訣秘訣

    您也可以查看專案的未使用參考,並一次全部移除這些參考。 如需詳細資訊,請參閱 HOW TO:移除未使用的參考 (Visual Basic)

移除 Visual C# 中的參考

  1. 在 [方案總管] 中,開啟專案節點下的 [參考] 節點。

  2. 以滑鼠右鍵按一下參考,然後按一下 [移除]。

請參閱

工作

中斷參考的疑難排解

HOW TO:加入或移除匯入的命名空間 (Visual Basic)

HOW TO:移除未使用的參考 (Visual Basic)

HOW TO:設定參考的複製到本機屬性

HOW TO:加入新專案項目

HOW TO:加入和移除 Web 參考

HOW TO:設定參考路徑 (C#)

參考

專案設計工具、應用程式頁 (C#)

進階編譯器設定對話方塊 (Visual Basic)

概念

專案參考

Visual Studio 中的 Web 參考

Visual Studio 多目標概觀

疑難排解 .NET Framework 目標錯誤

其他資源

管理參考

參考命名空間和元件

以特定的 .NET Framework 版本或設定檔為目標