Het gebruiken van bibliotheken en onderdelen

C++-projecten moeten vaak functies aanroepen of toegang krijgen tot gegevens in een binair bestand, zoals statische bibliotheek (LIB-bestanden), DLL, Windows Runtime-onderdeel, COM-onderdeel of .NET-assembly. In dergelijke gevallen moet u het project zo configureren dat het dat binaire bestand tijdens de build kan vinden. De specifieke stappen zijn afhankelijk van het type project, het type binair bestand en of het binaire bestand wordt ingebouwd in dezelfde oplossing als uw project.

Bibliotheken gebruiken die zijn gedownload via vcpkg

Als u een bibliotheek wilt gebruiken die u hebt gedownload met behulp van vcpkg-pakketbeheer , kunt u de onderstaande instructies negeren. Voor meer informatie, zie:

• vcpkg in CMake-projecten
• Pakketten installeren en gebruiken met CMake in Visual Studio
• vcpkg in MSBuild-projecten
• Zelfstudie: Pakketten installeren en gebruiken met MSBuild in Visual Studio

Statische bibliotheken gebruiken

Als uw statische bibliotheekproject wordt ingebouwd in dezelfde oplossing:

1. #include de header-bestand(en) voor de statische bibliotheek met aanhalingstekens. In een typische oplossing begint het pad met ../<library project name>. IntelliSense helpt u deze te vinden.
2. Voeg een verwijzing toe naar het statische bibliotheekproject. Klik met de rechtermuisknop op Verwijzingen onder het toepassingsprojectknooppunt in Solution Explorer en kies Verwijzing toevoegen.

Als de statische bibliotheek geen deel uitmaakt van de oplossing:

1. Klik met de rechtermuisknop op het toepassingsprojectknooppunt in Solution Explorer en kies Eigenschappen.
2. Voeg op de eigenschappenpagina vc++-mappen het pad toe aan de map die het LIB-bestand bevat aan bibliotheekmappen. Voeg vervolgens het pad naar het bibliotheekheaderbestand(en) toe aan Include Directories.
3. Voeg op de eigenschapspagina Linkerinvoer> de naam van het LIB-bestand toe aan Aanvullende Afhankelijkheden.

Dynamische koppelingsbibliotheken

Als het DLL-bestand wordt gebouwd als onderdeel van dezelfde oplossing als de toepassing, volgt u dezelfde stappen als voor een statische bibliotheek.

Als het DLL-bestand geen deel uitmaakt van de toepassingsoplossing, hebt u het volgende nodig: het DLL-bestand, de header(s) met prototypen voor de geëxporteerde functies en klassen, en een LIB-bestand dat de benodigde koppelingsinformatie biedt.

1. Kopieer het DLL-bestand naar de uitvoermap van uw project of naar een andere map in het standaardzoekpad van Windows voor DLL's. Zie Dynamic-Link Bibliotheekzoekvolgordevoor meer informatie.
2. Volg stap 1-3 voor statische bibliotheken om de paden naar de headers en het LIB-bestand te bieden.

COM-objecten

Als uw systeemeigen C++-toepassing een COM-object moet gebruiken en dat object is geregistreerd, hoeft u alleen CoCreateInstance aan te roepen en de CLSID van het object door te geven. Het systeem vindt het in het Windows-register en laadt het. Een C++/CLI-project kan een COM-object op dezelfde manier gebruiken. Het kan ook worden gebruikt door een verwijzing toe te voegen vanuit de COM-lijst Add References > en deze te gebruiken via de runtime aanroepbare wrapper.

.NET-assembly's en Windows Runtime-onderdelen

In UWP- of C++/CLI-projecten gebruikt u .NET-assembly's of Windows Runtime-onderdelen door een verwijzing naar de assembly of het onderdeel toe te voegen. Onder het knooppunt Verwijzingen in een UWP- of C++/CLI-project ziet u verwijzingen naar veelgebruikte onderdelen. Klik met de rechtermuisknop op het knooppunt Verwijzingen in Solution Explorer om Reference Manager weer te geven en blader door de onderdelen die beschikbaar zijn op het systeem. Kies de knop Bladeren om naar een map te navigeren die een aangepast onderdeel bevat. Omdat .NET-assembly's en Windows Runtime-onderdelen ingebouwde typegegevens bevatten, kunt u hun methoden en klassen weergeven door met de rechtermuisknop te klikken en Weergave te kiezen in Objectbrowser.

Referentie-eigenschappen

Elk type verwijzing heeft eigenschappen. U kunt de eigenschappen bekijken door de verwijzing te selecteren in Solution Explorer en op Alt + Enter te drukken, of door met de rechtermuisknop op Eigenschappen te klikken en te kiezen. Sommige eigenschappen zijn alleen-lezen en sommige kunnen worden gewijzigd. Doorgaans hoeft u deze eigenschappen echter niet handmatig te wijzigen.

ActiveX-referentie-eigenschappen

ActiveX-referentie-eigenschappen zijn alleen beschikbaar voor verwijzingen naar COM-onderdelen. Deze eigenschappen worden alleen weergegeven wanneer u een COM-onderdeel selecteert in het deelvenster Verwijzingen . De eigenschappen kunnen niet worden gewijzigd.

• Volledig pad beheren

  Geeft het mappad weer van het besturingselement waarnaar wordt verwezen.

• Control-GUID

  Geeft de GUID weer voor het ActiveX-besturingselement.

• Versie van besturingselement

  Geeft de versie weer van het ActiveX-besturingselement waarnaar wordt verwezen.

• Naam van bibliotheek typen

  Geeft de naam weer van de bibliotheek met het type waarnaar wordt verwezen.

• Wrapper-hulpprogramma

  Geeft het hulpprogramma weer dat wordt gebruikt voor het bouwen van de interoperabiliteitsassembly vanuit de COM-bibliotheek of het ActiveX-besturingselement waarnaar wordt verwezen.

Eigenschappen van assembly-referenties (C++/CLI)

Eigenschappen van assemblyreferenties zijn alleen beschikbaar voor verwijzingen naar .NET Framework-assembly's in C++/CLI-projecten. Deze eigenschappen worden alleen weergegeven wanneer u een .NET Framework-assembly selecteert in het deelvenster Verwijzingen . De eigenschappen kunnen niet worden gewijzigd.

• Relatief pad

  Geeft het relatieve pad weer van de projectmap naar de assembly waarnaar wordt verwezen.

Bouw-eigenschappen

De volgende eigenschappen zijn beschikbaar voor verschillende soorten verwijzingen. Hiermee kunt u opgeven hoe u kunt bouwen met verwijzingen.

• Lokaal kopiëren

  Hiermee geeft u op of de assembly waarnaar wordt verwezen automatisch naar de doellocatie moet worden gekopieerd tijdens een build.

• Lokale satellietassembly's kopiëren (C++/CLI)

  Specificeert of de satellietassembly's van de verwezen assembly automatisch naar de doellocatie moeten worden gekopieerd tijdens een build. Alleen gebruikt als Copy Local is true.

• Referentieassembly-uitvoer

  Hiermee geeft u op dat deze assembly wordt gebruikt in het buildproces. De assembly wordt gebruikt op de opdrachtregel van de compiler tijdens de build, als true.

Project-tot-project referentie-eigenschappen

De volgende eigenschappen definiëren een project-naar-projectverwijzing van het project dat is geselecteerd in het deelvenster Verwijzingen naar een ander project in dezelfde oplossing. Zie Verwijzingen in een project beheren voor meer informatie.

• Afhankelijkheden van koppelingsbibliotheek

  Wanneer deze eigenschap Waar is, koppelt het projectsysteem de LIB-bestanden die het onafhankelijke project produceert in het afhankelijke project. Normaal gesproken geeft u True op.

• Project-id

  Identificeer het onafhankelijke project op unieke wijze. De eigenschapswaarde is een interne systeem-GUID die niet kan worden gewijzigd.

• Bibliotheekafhankelijkheidsinvoer gebruiken

  Wanneer deze eigenschap Onwaar is, zal het projectsysteem de OBJ-bestanden voor de bibliotheek die het onafhankelijke project produceert niet linken naar het afhankelijke project. Daarom schakelt deze waarde incrementele koppelingen uit. Normaal gesproken geeft u False op, omdat het bouwen van de toepassing lang kan duren als er veel onafhankelijke projecten zijn.

Alleen-lezen referentie-eigenschappen (COM & .NET)

De volgende eigenschappen bestaan op COM- en .NET-assemblyverwijzingen en kunnen niet worden gewijzigd.

• Assemblynaam

  Geeft de assemblynaam weer voor de assembly waarnaar wordt verwezen.

• Cultuur

  Geeft de cultuur van de geselecteerde verwijzing weer.

• Beschrijving

  Geeft de beschrijving van de geselecteerde verwijzing weer.

• Volledig pad

  Geeft het pad naar de assembly waarnaar wordt verwezen weer.

• Identiteit

  Voor de .NET Framework-assembly's wordt het volledige pad weergegeven. Voor COM-onderdelen wordt de GUID weergegeven.

• Etiket

  Geeft het label van de verwijzing weer.

• Naam

  Geeft de naam van de verwijzing weer.

• Token voor openbare sleutel

  Geeft het openbaresleuteltoken weer dat wordt gebruikt om de assembly waarnaar wordt verwezen te identificeren.

• Sterke naam

  true als de assembly waarnaar wordt verwezen een sterke naam heeft. Een sterke benoemde assembly heeft een unieke versie.

• Versie

  Geeft de versie weer van de assembly waarnaar wordt verwezen.

Zie ook

Referentie van de eigenschappenpagina van het C++-project
C++ compiler en build-eigenschappen instellen in Visual Studio