/WHOLEARCHIVE (Inclure tous les fichiers objet de bibliothèque)

  • Article

Forcez l’éditeur de liens à inclure tous les fichiers objet dans la bibliothèque statique dans l’exécutable lié.

Syntaxe

/WHOLEARCHIVE
/WHOLEARCHIVE :library

Arguments

bibliothèque
Nom de chemin d’accès facultatif à une bibliothèque statique. L’éditeur de liens inclut chaque fichier objet de cette bibliothèque.

Notes

L’option /WHOLEARCHIVE force l’éditeur de liens à inclure chaque fichier objet d’une bibliothèque statique spécifiée ou, si aucune bibliothèque n’est spécifiée, de toutes les bibliothèques statiques spécifiées à la commande LINK. Pour spécifier l’option /WHOLEARCHIVE pour plusieurs bibliothèques, vous pouvez utiliser plusieurs commutateurs /WHOLEARCHIVE sur la ligne de commande de l’éditeur de liens. Par défaut, l’éditeur de liens inclut des fichiers objet dans la sortie liée uniquement s’ils exportent des symboles référencés par d’autres fichiers objet dans l’exécutable. L’option /WHOLEARCHIVE permet à l’éditeur de liens de traiter tous les fichiers objet archivés dans une bibliothèque statique comme s’ils étaient spécifiés individuellement sur la ligne de commande de l’éditeur de liens.

L’option /WHOLEARCHIVE peut être utilisée pour réexporter tous les symboles d’une bibliothèque statique. Cela vous permet de vous assurer que tous vos codes, ressources et métadonnées de bibliothèque sont inclus lorsque vous créez un composant à partir de plusieurs bibliothèques statiques. Si vous voyez un avertissement LNK4264 lorsque vous créez une bibliothèque statique contenant des composants Windows Runtime à exporter, utilisez l’option /WHOLEARCHIVE lors de la liaison de cette bibliothèque à un autre composant ou application.

L’option /WHOLEARCHIVE a été introduite dans Visual Studio 2015 Update 2.

Pour définir cette option d'éditeur de liens dans Visual Studio

  1. Ouvrez la boîte de dialogue Pages de propriétés du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  2. Sélectionnez la page de Propriétés de configuration>Éditeur de liens>Ligne de commande.

  3. Ajoutez l’option /WHOLEARCHIVE à la zone de texte Options supplémentaires.

Voir aussi

Informations de référence sur l’éditeur de liens MSVC
Options de l’éditeur de liens MSVC