/WHOLEARCHIVE (include tutti i file oggetto della raccolta)

  • Articolo

Forzare il linker a includere tutti i file oggetto nella libreria statica nel file eseguibile collegato.

Sintassi

/WHOLEARCHIVE
/WHOLEARCHIVE:library

Argomenti

libreria
Percorso facoltativo di una libreria statica. Il linker include tutti i file oggetto di questa libreria.

Osservazioni:

L'opzione /WHOLEARCHIVE impone al linker di includere ogni file oggetto da una libreria statica specificata o, se non viene specificata alcuna libreria, da tutte le librerie statiche specificate al comando LINK. Per specificare l'opzione /WHOLEARCHIVE per più librerie, è possibile usare più di un'opzione /WHOLEARCHIVE nella riga di comando del linker. Per impostazione predefinita, il linker include i file oggetto nell'output collegato solo se esportano simboli a cui fanno riferimento altri file oggetto nel file eseguibile. L'opzione /WHOLEARCHIVE rende il linker considera tutti i file oggetto archiviati in una libreria statica come se fossero stati specificati singolarmente nella riga di comando del linker.

L'opzione /WHOLEARCHIVE può essere usata per esportare nuovamente tutti i simboli da una libreria statica. In questo modo è possibile assicurarsi che tutto il codice, le risorse e i metadati della libreria siano inclusi quando si crea un componente da più librerie statiche. Se viene visualizzato un avviso LNK4264 quando si crea una libreria statica che contiene componenti Windows Runtime per l'esportazione, usare l'opzione /WHOLEARCHIVE quando si collega tale libreria a un altro componente o app.

L'opzione /WHOLEARCHIVE è stata introdotta in Visual Studio 2015 Update 2.

Per impostare questa opzione del linker in Visual Studio

  1. Aprire la finestra di dialogo Pagine delle proprietà del progetto. Per altre informazioni, vedere Impostare il compilatore e le proprietà di compilazione.

  2. Selezionare la pagina delle >proprietà Proprietà del linker della riga di comando del linker>di configurazione.

  3. Aggiungere l'opzione /WHOLEARCHIVE alla casella di testo Opzioni aggiuntive.

Vedi anche

Informazioni di riferimento sul linker MSVC
Opzioni del linker MSVC