/WHOLEARCHIVE (包括所有程式庫目的檔)

強制連結器在連結可執行檔的靜態程式庫中包含所有物件檔。

語法

/WHOLEARCHIVE
/WHOLEARCHIVE： library

引數

程式庫
靜態程式庫的選擇性路徑名稱。 連結器包含此程式庫的每個物件檔案。

備註

/WHOLEARCHIVE 選項會強制連結器從指定的靜態程式庫包含每個物件檔案，如果沒有指定任何程式庫，則從指定至 LINK 命令的所有靜態程式庫。 若要指定多個程式庫的 /WHOLEARCHIVE 選項，您可以在連結器命令列上使用多個 /WHOLEARCHIVE 參數。 根據預設，連結器只會匯出可執行檔中其他物件檔所參考的符號時，才會在連結輸出中包含物件檔。 /WHOLEARCHIVE 選項可讓連結器將靜態程式庫中封存的所有物件檔案視為在連結器命令列上個別指定。

/WHOLEARCHIVE 選項可用來從靜態程式庫重新匯出所有符號。 這可讓您確定當您從多個靜態程式庫建立元件時，會包含所有程式庫程式碼、資源和中繼資料。 如果您在建立包含匯出Windows 執行階段元件的靜態程式庫時看到警告LNK4264，請在將該程式庫連結至另一個元件或應用程式時，使用 /WHOLEARCHIVE 選項。

Visual Studio 2015 Update 2 引進了 /WHOLEARCHIVE 選項。

在 Visual Studio 中設定這個連結器選項

1. 開啟專案的 [屬性頁] 對話方塊。 如需詳細資料，請參閱在 Visual Studio 中設定 C ++ 編譯器和組建屬性。

2. 選取 [ 組態屬性 > 連結器 > 命令列 ] 屬性頁。

3. 將 /WHOLEARCHIVE 選項新增至 [ 其他選項] 文字方塊。

另請參閱

MSVC 連結器參考
MSVC 連結器選項