Partager via

Consommation de bibliothèques et de composants

Les projets C++ doivent souvent appeler des fonctions ou accéder à des données contenues dans un fichier binaire tel qu’une bibliothèque statique (fichiers LIB), une DLL, un composant Windows Runtime, un composant COM ou un 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 projet, du type de fichier binaire et de si ce fichier binaire est généré dans la même solution que votre projet.

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

Pour consommer 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, voir :

Consommation de bibliothèques statiques

Si votre projet de bibliothèque statique est généré dans la même solution :

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

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

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud du projet d’application 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 répertoires de bibliothèque. Ajoutez ensuite le chemin d’accès vers le(s) fichier(s) d’en-tête de la bibliothèque dans Répertoires Include.
  3. Dans la page de propriétés Éditeur de liens>Entrée, ajoutez le nom du fichier LIB dans Dépendances supplémentaires.

Si la DLL est générée dans 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 même solution que l’application, vous avez besoin de la DLL elle-même, de(s) fichier(s) d’en-tête 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 standard des DLL sous Windows. Pour plus d’informations, consultez Dynamic-Link Library Search Order.
  2. Suivez les étapes 1 à 3 de la section sur les bibliothèques statiques afin de fournir les chemins d’accès aux fichiers d’en-tête 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 trouvera dans le Registre Windows et le chargera. Un projet C++/CLI peut consommer un objet COM de la même façon. Il peut également le consommer en lui ajoutant une référence depuis la liste Ajouter une référence > COM, puis en l’utilisant via son wrapper pouvant être appelé par le runtime.

Assemblys .NET et composants Windows Runtime

Dans les projets UWP ou C++/CLI, vous consommez 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 vers des composants couramment utilisés. Cliquez avec le bouton droit sur le nœud Références dans l’Explorateur de solutions pour afficher le Gestionnaire de références et parcourir les composants disponibles sur le système. Utilisez 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 Afficher 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 d’autres peuvent être modifiées. 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 sont affichées uniquement lorsque vous sélectionnez un composant COM dans le volet Références. Ces 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 de 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 d’un contrôle ActiveX.

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

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

  • Chemin 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 les 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 la valeur est true, l’assembly est utilisé sur la ligne de commande du compilateur pendant la génération.

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

Les propriétés suivantes définissent une référence entre projets, depuis le projet sélectionné dans le volet Références vers 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

    Quand cette propriété a la valeur True, le système de projet lie les fichiers LIB produits par le projet indépendant au projet dépendant. En général, vous devez spécifier 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

    Quand cette propriété a la valeur False, le système de projet ne lie pas les fichiers OBJ de la bibliothèque produite par le projet indépendant au projet dépendant. C’est la raison pour laquelle cette valeur désactive la liaison incrémentielle. En général, vous spécifiez False, car la génération de l’application peut prendre du 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’assemblys 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.

  • Name

    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

    Possède la valeur true si l’assembly référencé a un nom fort. Un assembly avec un nom fort a une version unique.

  • Version

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

Voir aussi

Informations de référence sur les pages de propriétés dans un projet C++
Définir le compilateur C++ et les propriétés de génération dans Visual Studio

  • Last updated on