Share via


使用連結庫和元件

C++ 專案通常需要呼叫函式或存取二進位檔中的數據,例如靜態庫(LIB 檔案)、DLL、Windows 執行階段元件、COM元件或 .NET 元件。 在這些情況下,您必須設定專案,才能在建置時找到該二進位檔。 特定步驟取決於項目的類型、二進位檔的類型,以及二進位檔是否建置在與專案相同的方案中。

使用透過 vcpkg 下載的連結庫

若要使用 vcpkg 套件管理員下載的連結庫,您可以忽略下列指示。 如需詳細資訊,請參閱

取用靜態庫

如果您的靜態庫專案建置在同一個解決方案中:

  1. 使用引號 #include 靜態庫的頭檔(s)。 在一般解決方案中,路徑會以 開頭 ../<library project name>。 IntelliSense 可協助您找到它。
  2. 新增靜態庫項目的參考。 以滑鼠右鍵按下 方案總管 中應用程式項目節點底下的 [參考],然後選擇 [新增參考]。

如果靜態庫不是解決方案的一部分:

  1. 以滑鼠右鍵按兩下 方案總管中的應用程式項目節點,然後選擇 [屬性]。
  2. 在 [ VC++ 目錄 ] 屬性頁中,將路徑新增至包含 LIB 檔案的目錄至 連結庫路徑。 然後,將路徑新增至連結庫頭檔(s) 以 包含目錄
  3. 在 [ 鏈接器 > 輸入 ] 屬性頁中,將 LIB 檔案的名稱新增至 [其他相依性]。

如果 DLL 建置為與應用程式相同解決方案的一部分,請遵循與靜態庫相同的步驟。

如果 DLL 不是應用程式解決方案的一部分,您需要:DLL 檔案、具有匯出函式和類別原型的標頭,以及提供必要連結資訊的 LIB 檔案。

  1. 將 DLL 複製到項目的輸出資料夾,或複製到標準 Windows 搜尋路徑中 DLL 的另一個資料夾。 如需詳細資訊,請參閱 動態連結庫搜尋順序
  2. 請依照步驟 1-3 取得靜態庫,以提供標頭和 LIB 檔案的路徑。

COM 物件

如果您的原生 C++ 應用程式需要取用 COM 物件,而且已註冊該物件,則您只需要呼叫 CoCreateInstance 並傳入物件的 CLSID。 系統會在 Windows 登錄中找到它,並加以載入。 C++/CLI 專案可以使用相同的方式取用 COM 物件。 或者,它可以藉由從 [新增參考 > COM ] 清單新增參考,並透過運行 時間可呼叫包裝函式取用它來取用它。

.NET 元件和 Windows 執行階段元件

在UWP或 C++/CLI 專案中,您可以藉由新增元件或元件的參考,來取用 .NET 元件或 Windows 執行階段元件。 在UWP或 C++/CLI 專案中的 [參考] 節點底下,您會看到常用元件的參考。 以滑鼠右鍵按兩下 方案總管中的 [參考] 節點,以顯示 [參考管理員],並瀏覽系統上可用的元件。 選擇 [ 瀏覽] 按鈕,巡覽至包含自定義元件的任何資料夾。 因為 .NET 元件和 Windows 執行階段元件包含內建類型資訊,因此您可以用滑鼠右鍵按兩下並選擇 [物件瀏覽器中的檢視] 來檢視其方法和類別。

參考屬性

每種參考類型都包含屬性。 您可以在方案總管中選取參考,然後按 Alt + Enter,或按一下滑鼠右鍵並選擇 [屬性] ,來檢視屬性。 有些屬性是只讀的,有些是可修改的。 不過,您通常不需要手動修改這些屬性。

ActiveX 參考屬性

ActiveX 參考屬性僅適用於 COM 元件的參考。 只有在您在 [參考] 窗格中選取 COM 元件時,才會顯示這些屬性。 屬性無法修改。

  • 控制項完整路徑

    顯示參考控制項的目錄路徑。

  • 控制項 GUID

    顯示 ActiveX 控制項的 GUID。

  • 控制項版本

    顯示參考 ActiveX 控制項的版本。

  • 類型程式庫名稱

    顯示參考類型程式庫的名稱。

  • 包裝函式工具

    顯示用來從參考 COM 連結庫或 ActiveX 控制件建置 Interop 元件的工具。

元件參考屬性 (C++/CLI)

元件參考屬性僅適用於 C++/CLI 專案中 .NET Framework 元件的參考。 只有在您在 [參考] 窗格中選取 .NET Framework 元件時,才會顯示這些屬性。 屬性無法修改。

  • 相對路徑

    顯示從專案目錄到參考組件的相對路徑。

組建屬性

各種參考類型都會提供下列屬性。 這些屬性可讓您指定如何使用參考進行建置。

  • 複製到本機

    指定是否要在建置期間,自動將參考組件複製到目標位置。

  • 複製本機附屬元件 (C++/CLI)

    指定是否要在建置期間,自動將參考組件的附屬組件複製到目標位置。 僅在 [複製到本機] true時才會使用。

  • 參考組件輸出

    指定此元件用於建置程式。 如果 true為 ,則元件會在建置期間於編譯程式命令行上使用。

專案對專案參考屬性

下列屬性會定義從 [參考] 窗格中選取的專案到相同方案中另一個專案的專案對項目參考。 如需詳細資訊,請參閱管理專案中的參考

  • 連結程式庫相依性

    當此屬性為 True 時,專案系統會將獨立項目產生的 LIB 檔案連結至相依專案。 一般而言,您會指定 True

  • 專案識別項

    用來唯一識別獨立專案。 屬性值是無法修改的內部系統 GUID。

  • 使用程式庫相依性輸入

    當此屬性為 False 時,項目系統不會將獨立專案產生的連結庫 OBJ 檔案連結到相依專案。 這就是為什麼此值會停用累加連結。 一般而言,您會指定 False ,因為如果有許多獨立專案,建置應用程式可能需要很長的時間。

唯讀參考屬性 (COM 和 .NET)

COM 和 .NET 元件參考上存在下列屬性,而且無法修改。

  • 組件名稱

    顯示參考組件的組件名稱。

  • 文化特性

    顯示選取參考的文化特性。

  • 說明

    顯示選取參考的描述。

  • 完整路徑

    顯示參考組件的目錄路徑。

  • 身分識別

    針對 .NET Framework 元件,顯示完整路徑。 針對 COM 元件,則會顯示 GUID。

  • 標籤

    顯示參考的標籤。

  • 名稱

    顯示參考的名稱。

  • 公開金鑰語彙基元

    顯示用來識別參考元件的公鑰令牌。

  • 強式名稱

    如果參考組件具有強式名稱,則為true 。 強名稱元件具有唯一的版本。

  • 版本

    顯示參考組件的版本。

另請參閱

C++ 專案屬性頁參考
在 Visual Studio 中設定 C ++ 編譯器和組建屬性