Könyvtárak és összetevők felhasználása

A C++-projekteknek gyakran függvényeket kell meghívnia, vagy olyan bináris fájlban lévő adatokat kell elérnie, mint a statikus kódtár (LIB-fájlok), a DLL, a Windows Futtatókörnyezet összetevő, a COM-összetevő vagy a .NET-szerelvény. Ezekben az esetekben konfigurálnia kell a projektet, hogy a létrehozáskor megtalálja a bináris fájlt. A konkrét lépések a projekt típusától, a bináris típustól és attól függenek, hogy a bináris a projektével megegyező megoldásban lesz-e felépítve.

Vcpkg-en keresztül letöltött könyvtárak használata

Ha a vcpkg-csomagkezelővel letöltött kódtárat szeretne használni, figyelmen kívül hagyhatja az alábbi utasításokat. További információkért lásd:

• vcpkg CMake-projektekben
• Csomagok telepítése és használata CMake-kel a Visual Studio-ban
• vcpkg az MSBuild-projektekben
• oktatóanyag: Csomagok telepítése és használata az MSBuild használatával a Visual Studio

Statikus könyvtárak használata

Ha a statikus kódtárprojekt ugyanabban a megoldásban lesz felépítve:

1. #include a statikus könyvtár fejlécfájljai idézőjelek használatával. Egy tipikus megoldásban az elérési út a következővel ../<library project name>kezdődik: . Az IntelliSense segít megtalálni.
2. Adjon hozzá egy hivatkozást a statikus erőforrástár-projekthez. Kattintson a jobb gombbal a Hivatkozások elemre az alkalmazásprojekt csomópontja alatt a Megoldáskezelőben , és válassza a Hivatkozás hozzáadása lehetőséget.

Ha a statikus kódtár nem része a megoldásnak:

1. Kattintson a jobb gombbal az alkalmazásprojekt csomópontjára a Megoldáskezelőben , majd válassza a Tulajdonságok lehetőséget.
2. A VC++ Könyvtárak tulajdonságlapon adja hozzá a LIB-fájlt tartalmazó könyvtár elérési útját a könyvtárkönyvtárakhoz. Ezután adja hozzá a könyvtári fejlécfájl(ok) elérési útját az Include könyvtárakhoz.
3. A Linker > bemeneti tulajdonságlapján adja hozzá a LIB-fájl nevét a További függőségek szolgáltatáshoz.

Dinamikus csatolási kódtárak

Ha a DLL ugyanannak a megoldásnak a részeként lesz felépítve, mint az alkalmazás, kövesse azokat a lépéseket, mint egy statikus kódtár esetében.

Ha a DLL nem része az alkalmazásmegoldásnak, szüksége van a DLL-fájlra, az exportált függvények és osztályok prototípusait tartalmazó fejléc(ek)re, valamint egy LIB-fájlra, amely biztosítja a szükséges csatolási információkat.

1. Másolja a DLL-t a projekt kimeneti mappájába, vagy a DLL-ek szabványos Windows keresési útvonalának egy másik mappájába. További információ: Dynamic-Link Könyvtárkeresési sorrend.
2. A statikus kódtárak esetében kövesse az 1–3. lépést a fejlécek és a LIB-fájl elérési útjának megadásához.

COM-objektumok

Ha a natív C++ alkalmazásnak COM-objektumot kell használnia, és az objektum regisztrálva van, csak annyit kell tennie, hogy meghívja a CoCreateInstance-t, és átadja az objektum CLSID azonosítóját. A rendszer megkeresi a Windows beállításjegyzékben, és betölti. A C++/CLI-projektek ugyanúgy használhatnak COM-objektumokat. Használhatja úgy is, hogy hozzáad egy hivatkozást a Hivatkozás hozzáadása > COM-listából , és felhasználja azt a futtatókörnyezet hívható burkolójával.

.NET-szerelvények és Windows-futtatókörnyezeti összetevők

UWP- vagy C++/CLI-projektekben .NET-szerelvényeket vagy Windows futtatókörnyezeti összetevőket használ fel, ha hivatkozást ad hozzá a szerelvényhez vagy az összetevőhöz. Az UWP- vagy C++/CLI-projekt Hivatkozások csomópontja alatt a gyakran használt összetevőkre mutató hivatkozások láthatók. Kattintson a jobb gombbal a MegoldáskezelőReferenciák csomópontjára a Referenciakezelő használatához, és tallózással keresse meg a rendszeren elérhető összetevőket. A Tallózás gombra kattintva keresse meg az egyéni összetevőt tartalmazó mappákat. Mivel a .NET-szerelvények és a Windows Futtatókörnyezet összetevői beépített típusinformációkat tartalmaznak, a metódusaik és osztályaik megtekintéséhez kattintson a jobb gombbal, és válassza a Nézet lehetőséget az Object Browserben.

Referenciatulajdonságok

Minden hivatkozástípus rendelkezik tulajdonságokkal. A tulajdonságok megtekintéséhez jelölje ki a referenciát a Megoldáskezelőben, és nyomja le az Alt + Enter billentyűkombinációt, vagy kattintson a jobb gombbal a Tulajdonságok gombra. Bizonyos tulajdonságok csak olvashatók, míg mások módosíthatók. Általában azonban nem kell manuálisan módosítania ezeket a tulajdonságokat.

ActiveX-referenciatulajdonságok

Az ActiveX-referenciatulajdonságok csak a COM-összetevőkre mutató hivatkozásokhoz érhetők el. Ezek a tulajdonságok csak akkor jelennek meg, ha kijelöl egy COM-összetevőt a Hivatkozások panelen. A tulajdonságok nem módosíthatók.

• Teljes elérési út szabályozása

  Megjeleníti a hivatkozott vezérlőelem könyvtárútvonalát.

• Vezérlő GUID

  Megjeleníti az ActiveX-vezérlő GUID azonosítót.

• Kontroll verzió

  Megjeleníti a hivatkozott ActiveX-vezérlő verzióját.

• Írja be az erőforrástár nevét

  Megjeleníti a hivatkozott típustár nevét.

• Burkolóeszköz

  Megjeleníti a hivatkozott COM-kódtárból vagy ActiveX-vezérlőből az interop-szerelvény létrehozásához használt eszközt.

Szerelvény-referencia tulajdonságai (C++/CLI)

Az összeállítási referenciatulajdonságok csak a C++/CLI-projektekben lévő .NET-keretrendszer-szerelvényekre mutató hivatkozásokhoz érhetők el. Ezek a tulajdonságok csak akkor jelennek meg, ha kiválaszt egy .NET-keretrendszer-szerelvényt a Hivatkozások panelen. A tulajdonságok nem módosíthatók.

• Relatív útvonal

  Megjeleníti a relatív útvonalat a projektkönyvtártól a referált összeállításig.

Építési tulajdonságok

A következő tulajdonságok különböző típusú hivatkozásokon érhetők el. Lehetővé teszik, hogy referenciák segítségével megadja a felépítés módját.

• Helyi másolás

  Megadja, hogy a hivatkozott szerelvény automatikusan átmásolható-e a célhelyre a buildelés során.

• Helyileg szatellit-összeállításokat másol (C++/CLI)

  Megadja, hogy a hivatkozott szerelvényhez tartozó műholdszerelvényeket automatikusan átmásolják-e a célhelyre a fordítási folyamat során. Csak akkor használatos, ha a Helyi másolás lehetőség van true.

• Referenciaszerelvény kimenete

  Előírja, hogy ezt a szerelvényt használják az építési folyamat során. Ha true, akkor a buildelés során a rendszer a fordító parancssorában használja a szerelvényt.

Projekt–projekt referencia tulajdonságai

Az alábbi tulajdonságok egy projektről projektre mutató hivatkozást határoznak meg a Hivatkozások panelen kiválasztott projektről egy másik projektre ugyanabban a megoldásban. További információt a projektek hivatkozásainak kezelése című témakörben talál.

• Erőforrástár-függőségek csatolása

  Ha ez a tulajdonság Igaz, a projektrendszer összekapcsolja a független projekt által előállított LIB-fájlokat a függő projekttel. Általában igaz értéket ad meg.

• Projektazonosító

  Egyedi azonosítást biztosít a független projekt számára. A tulajdonság értéke egy belső rendszer GUID azonosítója, amely nem módosítható.

• Erőforrástár függőségi bemeneteinek használata

  Ha ez a tulajdonság hamis, a projektrendszer nem kapcsolja össze a független projekt által előállított kódtár OBJ-fájljait a függő projekttel. Ezért ez az érték letiltja a növekményes csatolást. Általában a False (Hamis ) értéket kell megadnia, mert az alkalmazás létrehozása hosszú időt vehet igénybe, ha sok független projekt van.

Csak olvasható referenciatulajdonságok (COM > .NET)

Az alábbi tulajdonságok a COM- és .NET-szerelvényhivatkozásokon találhatók, és nem módosíthatók.

• Szerelvény neve

  Megjeleníti a hivatkozott szerelvény szerelvénynevét.

• Kulturális

  Megjeleníti a kijelölt hivatkozás kultúráját.

• Leírás

  A kijelölt hivatkozás leírását jeleníti meg.

• Teljes elérési út

  A hivatkozott összetevő könyvtárának elérési útvonalát jeleníti meg.

• Identitás

  A .NET-keretrendszer összeállítások számára megjelenik a teljes elérési út. COM-összetevők esetén megjeleníti a GUID azonosítót.

• címke

  Megjeleníti a hivatkozás címkéjét.

• Név

  Megjeleníti a hivatkozás nevét.

• Nyilvános kulcs token

  Megjeleníti a hivatkozott szerelvény azonosításához használt nyilvános kulcs jogkivonatát.

• Erős név

  true ha a hivatkozott szerelvénynek erős neve van. Az erős névvel ellátott assembly egyedi verzióval rendelkezik.

• verzió

  Megjeleníti a hivatkozott szerelvény verzióját.

Lásd még

C++ projekt tulajdonság oldalának referenciája
C++ fordító és buildtulajdonságok beállítása a Visual Studióban