/WHOLEARCHIVE (Dołącz wszystkie pliki obiektów biblioteki)

  • Artykuł

Wymuś dołączenie wszystkich plików obiektów do biblioteki statycznej w połączonym pliku wykonywalnego przez konsolidator.

Składnia

/WHOLEARCHIVE
/WHOLEARCHIVE:library

Argumenty

Biblioteki
Opcjonalna nazwa ścieżki do biblioteki statycznej. Konsolidator zawiera każdy plik obiektu z tej biblioteki.

Uwagi

/WHOLEARCHIVE opcja wymusza konsolidator dołączanie każdego pliku obiektu z określonej biblioteki statycznej lub jeśli nie jest określona biblioteka, ze wszystkich bibliotek statycznych określonych do polecenia LINK. Aby określić /WHOLEARCHIVE opcji dla wielu bibliotek, można użyć więcej niż jednego przełącznika /WHOLEARCHIVE w wierszu polecenia konsolidatora. Domyślnie konsolidator zawiera pliki obiektów w połączonych danych wyjściowych tylko wtedy, gdy wyeksportują symbole przywoływalne przez inne pliki obiektów w pliku wykonywalnego. /WHOLEARCHIVE opcja sprawia, że konsolidator traktuje wszystkie pliki obiektów zarchiwizowane w bibliotece statycznej tak, jakby zostały określone indywidualnie w wierszu polecenia konsolidatora.

Opcji /WHOLEARCHIVE można użyć do ponownego wyeksportowania wszystkich symboli z biblioteki statycznej. Dzięki temu można upewnić się, że cały kod biblioteki, zasoby i metadane są uwzględniane podczas tworzenia składnika z więcej niż jednej biblioteki statycznej. Jeśli podczas tworzenia biblioteki statycznej zawierającej środowisko wykonawcze systemu Windows składników do eksportu zostanie wyświetlone ostrzeżenie LNK4264, użyj opcji /WHOLEARCHIVE podczas łączenia tej biblioteki z innym składnikiem lub aplikacją.

Opcja /WHOLEARCHIVE została wprowadzona w programie Visual Studio 2015 Update 2.

Aby ustawić tę opcję konsolidatora w programie Visual Studio

  1. Otwórz okno dialogowe Strony właściwości projektu. Aby uzyskać więcej informacji, zobacz Set C++ compiler and build properties in Visual Studio (Ustawianie właściwości kompilatora języka C++ i kompilacji w programie Visual Studio).

  2. Wybierz stronę właściwości wiersza polecenia konsolidatora>konfiguracji.>

  3. /WHOLEARCHIVE Dodaj opcję do pola tekstowego Dodatkowe opcje.

Zobacz też

Dokumentacja konsolidatora MSVC
Opcje konsolidatora MSVC