Freigeben über

Verwenden von Bibliotheken und Komponenten

In C++-Projekten ist oft der Aufruf von Funktionen oder der Zugriff auf Daten in einer Binärdatei wie einer statischen Bibliothek (LIB-Dateien), einer DLL, einer Komponente für Windows-Runtime, einer COM-Komponente oder einer .NET-Assembly erforderlich. In diesen Fällen müssen Sie das Projekt so konfigurieren, dass die Binärdatei zur Buildzeit gefunden werden kann. Die genauen Schritte hängen vom Typ Ihres Projekts, dem Typ der Binärdatei sowie davon ab, ob die Binärdatei in derselben Projektmappe wie Ihr Projekt erstellt wird.

Verwenden von über vcpkg heruntergeladenen Bibliotheken

Um eine Bibliothek zu nutzen, die Sie mithilfe des vcpkg-Paket-Managers heruntergeladen haben, können Sie die folgenden Anweisungen ignorieren. Weitere Informationen finden Sie unter:

Verwenden von statischen Bibliotheken

Gehen Sie folgendermaßen vor, wenn Ihr Projekt mit statischer Bibliothek in derselben Projektmappe erstellt wird:

  1. #include die Kopfzeilendatei(n) für die statische Bibliothek mit Anführungszeichen. In einer normalen Projektmappe beginnt der Pfad mit ../<library project name>. IntelliSense unterstützt Sie bei der Suche danach.
  2. Fügen Sie einen Verweis auf das Projekt mit statischer Bibliothek hinzu. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Verweise unter dem Projektknoten des Anwendungsprojekts, und wählen Sie "Verweis hinzufügen" aus.

Gehen Sie folgendermaßen vor, wenn die statische Bibliothek nicht Teil der Projektmappe ist:

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten der Anwendung, und wählen Sie dann "Eigenschaften" aus.
  2. Fügen Sie auf der Eigenschaftenseite "VC++-Verzeichnisse " den Pfad zum Verzeichnis hinzu, das die LIB-Datei zu Bibliotheksverzeichnissen enthält. Fügen Sie dann den Pfad zur Bibliothekskopfdatei(n) zu Include-Verzeichnissen hinzu.
  3. Fügen Sie auf der Seite "Linker > Input"-Eigenschaft den Namen der LIB-Datei zu Zusätzliche Abhängigkeiten hinzu.

Wenn die DLL als Teil derselben Projektmappe wie die der Anwendung erstellt wird, befolgen Sie dieselben Schritte wie für eine statische Bibliothek.

Wenn die DLL nicht Bestandteil der Projektmappe der Anwendung ist, benötigen Sie die DLL-Datei, die Header mit den Prototypen der exportierten Funktionen und Klassen und eine LIB-Datei, die die erforderlichen Verknüpfungsinformationen bereitstellt.

  1. Kopieren Sie die DLL in den Ausgabeordner Ihres Projekts oder in einen anderen Ordner unter dem Standardsuchpfad für DLLs unter Windows. Weitere Informationen finden Sie unter Dynamic-Link Bibliothekssuchreihenfolge.
  2. Befolgen Sie die Schritte 1–3 für statische Bibliotheken, um die Pfade zu den Headern und der LIB-Datei bereitzustellen.

COM-Objekte

Wenn Ihre systemeigene C++-Anwendung ein COM-Objekt verwenden muss und dieses Objekt registriert ist, müssen Sie nur CoCreateInstance aufrufen und die CLSID des Objekts übergeben. Das System findet und lädt CoCreateInstance in der Windows-Registrierung. Ein C++/CLI-Projekt kann ein COM-Objekt auf gleiche Weise nutzen. Man kann es auch verwenden, indem man einen Verweis aus der COM-Liste 'Verweise hinzufügen' hinzufügt und es über seinen aufrufbaren Laufzeit-Wrapper nutzt.

.NET-Assemblys und Windows-Runtimekomponenten

In UWP- oder C++/CLI-Projekten verwenden Sie .NET-Assemblys oder Windows-Runtime-Komponenten, indem Sie einen Verweis auf die Assembly oder Komponente hinzufügen. Unter dem Knoten "Verweise " in einem UWP- oder C++/CLI-Projekt werden Verweise auf häufig verwendete Komponenten angezeigt. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten "Verweise", um den Verweis-Manager anzuzeigen und die im System verfügbaren Komponenten zu durchsuchen. Wählen Sie die Schaltfläche " Durchsuchen " aus, um zu einem beliebigen Ordner zu navigieren, der eine benutzerdefinierte Komponente enthält. Da .NET-Assemblys und Windows-Runtime-Komponenten integrierte Typinformationen enthalten, können Sie ihre Methoden und Klassen anzeigen, indem Sie im Objektkatalog mit der rechten Maustaste klicken und "Ansicht" auswählen.

Verweiseigenschaften

Jede Art von Verweis verfügt über Eigenschaften. Sie können die Eigenschaften anzeigen, indem Sie den Verweis im Projektmappen-Explorer auswählen und Alt+Eingabetaste drücken oder mit der rechten Maustaste darauf klicken und Eigenschaften auswählen. Einige Eigenschaften sind schreibgeschützt, während andere geändert werden können. Allerdings müssen Sie diese Eigenschaften in der Regel nicht manuell ändern.

ActiveX-Verweiseigenschaften

ActiveX-Verweiseigenschaften sind nur für Verweise auf COM-Komponenten verfügbar. Diese Eigenschaften werden nur angezeigt, wenn Sie eine COM-Komponente im Bereich "Verweise " auswählen. Die Eigenschaften können nicht geändert werden.

  • Vollständigen Pfad steuern

    Zeigt den Verzeichnispfad des Steuerelements an, auf das verwiesen wird.

  • Steuerelement-GUID

    Zeigt de GUID für das ActiveX-Steuerelement an.

  • Versionskontrolle

    Zeigt die Version des ActiveX-Steuerelements an, auf das verwiesen wird.

  • Typbibliotheksname

    Zeigt den Namen der Typbibliothek an, auf die verwiesen wird.

  • Wrappertool

    Hiermit wird das Tool angezeigt, das zum Erstellen der Interopassembly aus der COM-Bibliothek oder dem ActiveX-Steuerelement verwendet wird, auf die bzw. das verwiesen wird.

Assemblyverweiseigenschaften (C++/CLI)

Assemblyverweiseigenschaften sind nur für Verweise auf .NET Framework-Assemblys in C++-/CLI-Projekten verfügbar. Diese Eigenschaften werden nur angezeigt, wenn Sie eine .NET Framework-Assembly im Bereich "Verweise " auswählen. Die Eigenschaften können nicht geändert werden.

  • Relativer Pfad

    Zeigt den relativen Pfad vom Projektverzeichnis zur Assembly an, auf die verwiesen wird.

Buildeigenschaften

Die folgenden Eigenschaften stehen für verschiedene Arten von Verweisen zur Verfügung. Sie ermöglichen Ihnen die Angabe, wie die Erstellung mit Verweisen erfolgen soll.

  • Lokal kopieren

    Gibt an, ob die Assembly, auf die verwiesen wird, während eines Buildvorgangs automatisch an den Zielspeicherort kopiert wird.

  • Lokale Satellitenassemblys kopieren (C++/CLI)

    Gibt an, ob die Satellitenassemblys der Assembly, auf die verwiesen wird, während eines Buildvorgangs automatisch an den Zielspeicherort kopiert werden. Wird nur verwendet, wenn „Lokal kopieren“true aktiviert ist.

  • Referenzassemblyausgabe

    Hiermit wird angegeben, dass die Assembly im Buildprozess verwendet wird. Wenn true, wird die Assembly während des Buildvorgangs an der Befehlszeile des Compilers verwendet.

Interprojektverweiseigenschaften

Die folgenden Eigenschaften definieren einen Projekt-zu-Projekt-Verweis aus dem Projekt, das im Bereich 'Verweise' ausgewählt ist, auf ein anderes Projekt in derselben Projektmappe. Weitere Informationen finden Sie unter Verwalten von Verweisen in einem Projekt.

  • Verknüpfungsbibliotheksabhängigkeiten

    Wenn diese Eigenschaft "True" ist, verknüpft das Projektsystem die LIB-Dateien, die das unabhängige Projekt erzeugt, in das abhängige Projekt. Normalerweise geben Sie True an.

  • Projektbezeichner

    Identifiziert eindeutig das unabhängige Projekt. Der Eigenschaftswert ist eine interne System-GUID, die nicht geändert werden kann.

  • Verwenden von Bibliotheksabhängigkeitseingaben

    Wenn diese Eigenschaft "False" lautet, verknüpft das Projektsystem die OBJ-Dateien nicht für die Bibliothek, die das unabhängige Projekt in das abhängige Projekt erzeugt. Folglich deaktiviert dieser Wert inkrementelles Verknüpfen. In der Regel geben Sie "False" an, da das Erstellen der Anwendung sehr lange dauern kann, wenn viele unabhängige Projekte vorhanden sind.

Schreibgeschützte Verweiseigenschaften (COM & .NET)

Die folgenden Eigenschaften gelten für COM- und Assemblyverweise und können nicht geändert werden.

  • Assemblyname

    Zeigt den Assemblynamen für die Assembly an, auf die verwiesen wird.

  • Kultur

    Zeigt die Kultur des ausgewählten Verweises an.

  • Beschreibung

    Zeigt die Beschreibung des ausgewählten Verweises an.

  • Vollständiger Pfad

    Zeigt den Verzeichnispfad der Assembly an, auf die verwiesen wird.

  • Identität

    Für die .NET Framework-Assemblys wird der vollständige Pfad angezeigt. Zeigt die GUID für COM-Komponenten an.

  • Etikett

    Zeigt die Bezeichnung des Verweises an.

  • Name

    Zeigt den Namen des Verweises an.

  • Öffentliches Schlüsseltoken

    Hiermit wird das öffentliche Schlüsseltoken zur Identifizierung der Assembly angegeben, auf die verwiesen wird.

  • Starker Name

    true, wenn die Assembly, auf die verwiesen wird, einen starken Namen besitzt. Eine Assembly mit starkem Namen verfügt über eine eindeutige Versionsangabe.

  • Version

    Zeigt die Version der Assembly an, auf die verwiesen wird.

Siehe auch

Referenz für Eigenschaftsseiten von C++-Projekten
Festlegen von C++-Compiler- und Buildeigenschaften in Visual Studio