Consommation de bibliothèques et de composants

Les projets C++ ont souvent besoin d’appeler des fonctions ou d’accéder à des données dans un fichier binaire tel que des fichiers bibliothèque statiques (fichiers LIB), DLL, composant Windows Runtime, composant COM ou assembly .NET. Dans ces cas, vous devez configurer le projet afin qu’il puisse trouver ce fichier binaire au moment de la génération. Les étapes spécifiques dépendent du type de votre projet, du type du fichier binaire et du fait que le fichier binaire est intégré à la même solution que votre projet.

Consommation de bibliothèques téléchargées via vcpkg

Pour utiliser une bibliothèque que vous avez téléchargée à l’aide du gestionnaire de package vcpkg , vous pouvez ignorer les instructions ci-dessous. Pour plus d’informations, consultez l’article suivant :

• vcpkg dans les projets CMake
• Installer et utiliser des packages avec CMake dans Visual Studio
• vcpkg dans les projets MSBuild
• Tutoriel : Installer et utiliser des packages avec MSBuild dans Visual Studio

Consommation de bibliothèques statiques

Si votre projet de bibliothèque statique est intégré à la même solution :

1. #include le ou les fichiers d’en-tête de la bibliothèque statique à l’aide de guillemets. Dans une solution classique, le chemin commence par ../<library project name>. IntelliSense vous aidera à le trouver.
2. Ajoutez une référence au projet de bibliothèque statique. Cliquez avec le bouton droit sur Références sous le nœud du projet d’application dans Explorateur de solutions, puis choisissez Ajouter une référence.

Si la bibliothèque statique ne fait pas partie de la solution :

1. Cliquez avec le bouton droit sur le nœud du projet d’application dans Explorateur de solutions, puis choisissez Propriétés.
2. Dans la page de propriétés répertoires VC++, ajoutez le chemin d’accès au répertoire qui contient le fichier LIB aux chemins de bibliothèque. Ensuite, ajoutez le chemin d’accès au ou les fichiers d’en-tête de la bibliothèque dans les répertoires Include.
3. Dans la page de propriétés d’entrée de l’éditeur > de liens, ajoutez le nom du fichier LIB aux dépendances supplémentaires.

Bibliothèques de liens dynamiques

Si la DLL est générée dans le cadre de la même solution que l’application, suivez les mêmes étapes que pour une bibliothèque statique.

Si la DLL ne fait pas partie de la solution d’application, vous avez besoin du fichier DLL, du ou des en-têtes avec des prototypes pour les fonctions et classes exportées et d’un fichier LIB qui fournit les informations de liaison nécessaires.

1. Copiez la DLL dans le dossier de sortie de votre projet ou vers un autre dossier dans le chemin de recherche Windows standard pour les DLL. Pour plus d’informations, consultez l’ordre de recherche de la bibliothèque de liens dynamiques.
2. Suivez les étapes 1 à 3 pour les bibliothèques statiques afin de fournir les chemins d’accès aux en-têtes et au fichier LIB.

objets COM

Si votre application C++ native doit consommer un objet COM et que cet objet est inscrit, il vous suffit d’appeler CoCreateInstance et de passer le CLSID de l’objet. Le système le trouve dans le Registre Windows et le charge. Un projet C++/CLI peut consommer un objet COM de la même façon. Il peut également l’utiliser en lui ajoutant une référence à partir de la liste COM Ajouter des références > et en l’consommant via son wrapper pouvant être appelé runtime.

Assemblys .NET et composants Windows Runtime

Dans les projets UWP ou C++/CLI, vous utilisez des assemblys .NET ou des composants Windows Runtime en ajoutant une référence à l’assembly ou au composant. Sous le nœud Références d’un projet UWP ou C++/CLI, vous voyez des références aux composants couramment utilisés. Cliquez avec le bouton droit sur le nœud Références dans Explorateur de solutions pour afficher le Gestionnaire de références et parcourir les composants disponibles sur le système. Choisissez le bouton Parcourir pour accéder à n’importe quel dossier contenant un composant personnalisé. Étant donné que les assemblys .NET et les composants Windows Runtime contiennent des informations de type intégrées, vous pouvez afficher leurs méthodes et classes en cliquant avec le bouton droit et en choisissant Affichage dans l’Explorateur d’objets.

Propriétés de référence

Chaque genre de référence possède des propriétés. Pour afficher les propriétés, sélectionnez la référence dans l’Explorateur de solutions et appuyez sur Alt+Entrée, ou cliquez avec le bouton droit et choisissez Propriétés. Certaines propriétés sont en lecture seule et certaines sont modifiables. Toutefois, en règle générale, vous n’avez pas à modifier ces propriétés manuellement.

Propriétés de référence ActiveX

Les propriétés de référence ActiveX sont disponibles uniquement pour les références aux composants COM. Ces propriétés s’affichent uniquement lorsque vous sélectionnez un composant COM dans le volet Références . Les propriétés ne sont pas modifiables.

• Chemin d’accès complet du contrôle

  Affiche le chemin d'accès du répertoire du contrôle référencé.

• GUID du contrôle

  Affiche le GUID du contrôle ActiveX.

• Version de contrôle

  Affiche la version du contrôle ActiveX référencé.

• Nom de la bibliothèque de types

  Affiche le nom de la bibliothèque de types référencée.

• Outil wrapper

  Affiche l’outil utilisé pour générer l’assembly d’interopérabilité à partir de la bibliothèque COM référencée ou du contrôle ActiveX.

Propriétés de référence d’assembly (C++/CLI)

Les propriétés de référence d’assembly sont disponibles uniquement pour les références aux assemblys .NET Framework dans les projets C++/CLI. Ces propriétés s’affichent uniquement lorsque vous sélectionnez un assembly .NET Framework dans le volet Références . Les propriétés ne sont pas modifiables.

• Chemin d’accès relatif

  Affiche le chemin d'accès relatif du répertoire de projet à l'assembly référencé.

Propriétés de la build

Les propriétés suivantes sont disponibles sur divers genres de références. Elles vous permettent de spécifier le mode de génération avec des références.

• Copie locale

  Spécifie si l'assembly référencé doit être copié automatiquement vers l'emplacement cible pendant une génération.

• Copier des assemblys satellites locaux (C++/CLI)

  Spécifie si les assemblys satellites de l'assembly référencé doivent être copiés automatiquement vers l'emplacement cible pendant une génération. Utilisé uniquement si Copie locale a la valeur true.

• Sortie de l’assembly de référence

  Spécifie que cet assembly est utilisé dans le processus de génération. Si true, l’assembly est utilisé sur la ligne de commande du compilateur pendant la build.

Propriétés de référence entre projets

Les propriétés suivantes définissent une référence de projet à projet à partir du projet sélectionné dans le volet Références d’un autre projet dans la même solution. Pour plus d’informations, consultez Gestion des références dans un projet.

• Lier les dépendances de la bibliothèque

  Lorsque cette propriété a la valeur True, le système de projet lie les fichiers LIB générés par le projet indépendant dans le projet dépendant. En règle générale, vous spécifiez True.

• Identificateur de projet

  Identifie de façon unique le projet indépendant. La valeur de propriété est un GUID système interne qui n’est pas modifiable.

• Utiliser les entrées de dépendance de la bibliothèque

  Lorsque cette propriété a la valeur False, le système de projet ne lie pas les fichiers OBJ de la bibliothèque que le projet indépendant produit dans le projet dépendant. C’est pourquoi cette valeur désactive la liaison incrémentielle. En règle générale, vous spécifiez False , car la création de l’application peut prendre beaucoup de temps s’il existe de nombreux projets indépendants.

Propriétés de référence en lecture seule (COM &.NET)

Les propriétés suivantes existent sur les références d’assembly COM et .NET et ne sont pas modifiables.

• Nom de l’assembly

  Affiche le nom de l'assembly pour l'assembly référencé.

• Culture

  Affiche la culture de la référence sélectionnée.

• Description

  Affiche la description de la référence sélectionnée.

• Chemin d'accès complet

  Affiche le chemin d'accès du répertoire de l'assembly référencé.

• Identité

  Pour les assemblys .NET Framework, affiche le chemin d’accès complet. Pour les composants COM, affiche le GUID.

• Étiquette

  Affiche l'étiquette de la référence.

• Nom

  Affiche le nom de la référence.

• Jeton de clé publique

  Affiche le jeton de clé publique utilisé pour identifier l’assembly référencé.

• Nom fort

  true si l'assembly référencé a un nom fort. Un assembly nommé fort a une version unique.

• Version

  Affiche la version de l'assembly référencé.

Voir aussi

Informations de référence sur la page de propriétés du projet C++
Définir le compilateur C++ et les propriétés de build dans Visual Studio