Dela via

Använda bibliotek och komponenter

C++-projekt behöver ofta anropa funktioner eller komma åt data i en binär fil, till exempel statiskt bibliotek (LIB-filer), DLL, Windows Runtime-komponent, COM-komponent eller .NET-sammansättning. I dessa fall måste du konfigurera projektet så att det kan hitta binärfilen vid byggtiden. De specifika stegen beror på typen av projekt, typen av binärfil och om binärfilen byggs i samma lösning som projektet.

Att använda bibliotek som har laddats ner via vcpkg

Om du vill använda ett bibliotek som du har laddat ned med vcpkg-pakethanteraren kan du ignorera anvisningarna nedan. Mer information finns i:

Använda statiska bibliotek

Om ditt statiska biblioteksprojekt byggs in i samma lösning:

  1. #include headerfil(er) för det statiska biblioteket med citattecken. I en typisk lösning börjar sökvägen med ../<library project name>. IntelliSense hjälper dig att hitta den.
  2. Lägg till en referens till det statiska biblioteksprojektet. Högerklicka på Referenser under programprojektnoden i Solution Explorer och välj Lägg till referens.

Om det statiska biblioteket inte ingår i lösningen:

  1. Högerklicka på programprojektnoden i Solution Explorer och välj sedan Egenskaper.
  2. På egenskapssidan VC++ Kataloger lägger du till sökvägen till katalogen som innehåller LIB-filen i bibliotekskataloger. Lägg sedan till sökvägen till bibliotekshuvudfilerna i Inkludera kataloger.
  3. På egenskapssidan Linker-ingång > lägger du till namnet på LIB-filen i Ytterligare beroenden.

Om DLL:en skapas som en del av samma lösning som programmet följer du samma steg som för ett statiskt bibliotek.

Om DLL inte ingår i programlösningen behöver du: DLL-filen, sidhuvudena med prototyper för de exporterade funktionerna och klasserna och en LIB-fil som tillhandahåller nödvändig länkningsinformation.

  1. Kopiera DLL:en till utdatamappen för projektet eller till en annan mapp i windows standardsökväg för DLL:er. Mer information finns i Dynamic-Link sökordning för bibliotek.
  2. Följ steg 1–3 för statiska bibliotek för att ange sökvägarna till rubrikerna och LIB-filen.

COM-objekt

Om ditt interna C++-program behöver använda ett COM-objekt, och det objektet är registrerat, behöver du bara anropa CoCreateInstance och skicka in CLSID för objektet. Systemet hittar det i Windows-registret och läser in det. Ett C++/CLI-projekt kan använda ett COM-objekt på samma sätt. Eller så kan den använda den genom att lägga till en referens till den från com-listan Lägg till referenser > och använda den via sin runtime-anropsbara omslutning.

.NET-sammansättningar och Windows Runtime-komponenter

I UWP- eller C++/CLI-projekt använder du .NET-sammansättningar eller Windows Runtime-komponenter genom att lägga till en referens till sammansättningen eller komponenten. Under noden Referenser i ett UWP- eller C++/CLI-projekt ser du referenser till vanliga komponenter. Högerklicka på noden Referenser i Solution Explorer för att ta fram referenshanteraren och bläddra igenom de komponenter som är tillgängliga i systemet. Välj knappen Bläddra för att navigera till en mapp som innehåller en anpassad komponent. Eftersom .NET-sammansättningar och Windows Runtime-komponenter innehåller inbyggd typinformation kan du visa deras metoder och klasser genom att högerklicka och välja Visa i Object Browser.

Referensegenskaper

Varje typ av referens har egenskaper. Du kan visa egenskaperna genom att välja referensen i Solution Explorer och trycka på Alt + Retur, eller högerklicka och välja Egenskaper. Vissa egenskaper är endast läsbara och vissa kan ändras. Normalt behöver du dock inte ändra dessa egenskaper manuellt.

ActiveX-referensegenskaper

ActiveX-referensegenskaper är endast tillgängliga för referenser till COM-komponenter. Dessa egenskaper visas endast när du väljer en COM-komponent i fönstret Referenser . Egenskaperna kan inte ändras.

  • Kontrollera fullständig sökväg

    Visar katalogsökvägen för den refererade kontrollen.

  • Kontroll-GUID

    Visar GUID för ActiveX-kontrollen.

  • Kontrollversion

    Visar versionen av den refererade ActiveX-kontrollen.

  • Skriv biblioteksnamn

    Visar namnet på det refererade typbiblioteket.

  • Förpackningsverktyg

    Visar verktyget som används för att skapa interop-sammansättningen från det refererade COM-biblioteket eller ActiveX-kontrollen.

Sammansättningsreferensegenskaper (C++/CLI)

Sammansättningsreferensegenskaper är endast tillgängliga för referenser till .NET Framework-sammansättningar i C++/CLI-projekt. Dessa egenskaper visas endast när du väljer en .NET Framework-sammansättning i fönstret Referenser . Egenskaperna kan inte ändras.

  • Relativ sökväg

    Visar den relativa sökvägen från projektkatalogen till den refererade sammansättningen.

Skapa egenskaper

Följande egenskaper är tillgängliga för olika typer av referenser. De gör att du kan ange hur du skapar med referenser.

  • Kopiera lokalt

    Anger huruvida den refererade samlingen ska kopieras automatiskt till målplatsen under en kompilering.

  • Kopiera lokala satellitsammansättningar (C++/CLI)

    Anger huruvida satellitsammansättningarna för den refererade sammansättningen ska kopieras automatiskt till målplatsen under en kompilering. Används endast om Kopiera lokal är true.

  • Referensmonteringens resultat

    Anger att den här sammansättningen används i byggprocessen. Om trueanvänds sammansättningen på kommandoraden för kompilatorn under bygget.

Referensegenskaper för projekt till projekt

Följande egenskaper definierar en projekt-till-projekt-referens från projektet som har valts i fönstret Referenser till ett annat projekt i samma lösning. Mer information finns i Hantera referenser i ett projekt.

  • Beroenden på länkbibliotek

    När den här egenskapen är True länkar projektsystemet LIB-filerna som det oberoende projektet skapar med det beroende projektet. Vanligtvis anger du Sant.

  • Projektidentifierare

    Identifierar unikt det oberoende projektet. Egenskapsvärdet är ett internt system-GUID som inte kan ändras.

  • Använda biblioteksberoendeindata

    När den här egenskapen är False länkar inte projektsystemet OBJ-filerna för biblioteket som det oberoende projektet skapar till det beroende projektet. Därför inaktiverar det här värdet inkrementell länkning. Vanligtvis anger du False eftersom det kan ta lång tid att skapa programmet om det finns många oberoende projekt.

Skrivskyddade referensegenskaper (COM & .NET)

Följande egenskaper finns på COM- och .NET-sammansättningsreferenser och kan inte ändras.

  • Sammansättningsnamn

    Visar sammansättningsnamnet för den refererade sammansättningen.

  • Kultur

    Visar kulturen för den valda referensen.

  • Beskrivning

    Visar beskrivningen av den valda referensen.

  • Fullständig sökväg

    Visar katalogsökvägen för den refererade sammansättningen.

  • Identitet

    För .NET Framework-sammansättningarna visar den fullständiga sökvägen. För COM-komponenter visar den GUID.

  • Etikett

    Visar etiketten för referensen.

  • Namn

    Visar namnet på referensen.

  • Token för offentlig nyckel

    Visar den offentliga nyckeltoken som används för att identifiera den refererade sammansättningen.

  • Starkt namn

    true om den refererade sammansättningen har ett starkt namn. En stark namngiven sammansättning har en unik version.

  • Version:

    Visar versionen av den refererade sammansättningen.

Se även

Referens för C++-projektegenskapssida
Ange C++-kompilator- och byggegenskaper i Visual Studio