Korzystanie z bibliotek i składników

Artykuł
12/22/2023

Projekty języka C++ często wymagają wywoływania funkcji lub uzyskiwania dostępu do danych w pliku binarnym, takim jak biblioteka statyczna (pliki LIB), biblioteka DLL, składnik środowisko wykonawcze systemu Windows, składnik COM lub zestaw .NET. W takich przypadkach należy skonfigurować projekt, aby można było znaleźć ten plik binarny w czasie kompilacji. Konkretne kroki zależą od typu projektu, typu pliku binarnego i tego, czy plik binarny zostanie skompilowany w tym samym rozwiązaniu co projekt.

Korzystanie z bibliotek pobranych za pośrednictwem narzędzia vcpkg

Aby korzystać z biblioteki pobranej przy użyciu menedżera pakietów vcpkg , możesz zignorować poniższe instrukcje. Aby uzyskać więcej informacji, zobacz:

Korzystanie z bibliotek statycznych

Jeśli projekt biblioteki statycznej zostanie skompilowany w tym samym rozwiązaniu:

#include plików nagłówków dla biblioteki statycznej przy użyciu cudzysłowów. W typowym rozwiązaniu ścieżka rozpoczyna się od ../<library project name>. Funkcja IntelliSense pomoże Ci go znaleźć.
Dodaj odwołanie do projektu biblioteki statycznej. Kliknij prawym przyciskiem myszy pozycję Odwołania w węźle projektu aplikacji w Eksplorator rozwiązań i wybierz polecenie Dodaj odwołanie.

Jeśli biblioteka statyczna nie jest częścią rozwiązania:

Kliknij prawym przyciskiem myszy węzeł projektu aplikacji w Eksplorator rozwiązań, a następnie wybierz polecenie Właściwości.
Na stronie właściwości Katalogi VC++ dodaj ścieżkę do katalogu zawierającego plik LIB do ścieżek biblioteki. Następnie dodaj ścieżkę do plików nagłówków biblioteki, aby uwzględnić katalogi.
Na stronie właściwości Input konsolidatora > dodaj nazwę pliku LIB do dodatkowych zależności.

Biblioteki łączy dynamicznych

Jeśli biblioteka DLL zostanie skompilowana jako część tego samego rozwiązania co aplikacja, wykonaj te same kroki co w przypadku biblioteki statycznej.

Jeśli biblioteka DLL nie jest częścią rozwiązania aplikacji, potrzebujesz: pliku DLL, nagłówków z prototypami dla wyeksportowanych funkcji i klas oraz pliku LIB, który zapewnia niezbędne informacje dotyczące łączenia.

Skopiuj bibliotekę DLL do folderu wyjściowego projektu lub do innego folderu w standardowej ścieżce wyszukiwania systemu Windows dla bibliotek DLL. Aby uzyskać więcej informacji, zobacz Dynamic-Link Library Search Order (Kolejność wyszukiwania biblioteki dynamicznej).
Wykonaj kroki od 1 do 3 dla bibliotek statycznych, aby podać ścieżki do nagłówków i pliku LIB.

obiekty COM

Jeśli natywna aplikacja języka C++ musi korzystać z obiektu COM i ten obiekt jest zarejestrowany, wystarczy wywołać metodę CoCreateInstance i przekazać identyfikator CLSID obiektu. System znajdzie go w rejestrze systemu Windows i załaduje go. Projekt C++/CLI może korzystać z obiektu COM w taki sam sposób. Można go również użyć, dodając odwołanie do niego z listy Add References COM (Dodawanie odwołań > COM ) i korzystając z niej za pośrednictwem wywoływanej otoki środowiska uruchomieniowego.

Zestawy platformy .NET i składniki środowisko wykonawcze systemu Windows

W projektach platformy UWP lub C++/cli używane są zestawy platformy .NET lub składniki środowisko wykonawcze systemu Windows przez dodanie odwołania do zestawu lub składnika. W węźle Odwołania w projekcie platformy UWP lub C++/interfejsu wiersza polecenia są widoczne odwołania do często używanych składników. Kliknij prawym przyciskiem myszy węzeł Odwołania w Eksplorator rozwiązań, aby wyświetlić Menedżera odwołań i przejrzeć składniki dostępne w systemie. Wybierz przycisk Przeglądaj, aby przejść do dowolnego folderu zawierającego składnik niestandardowy. Ponieważ zestawy .NET i składniki środowisko wykonawcze systemu Windows zawierają wbudowane informacje o typie, można wyświetlić ich metody i klasy, klikając prawym przyciskiem myszy i wybierając polecenie Widok w przeglądarce obiektów.

Właściwości odwołania

Każdy rodzaj odwołania ma właściwości. Właściwości można wyświetlić, wybierając odwołanie w Eksplorator rozwiązań i naciskając klawisze Alt + Enter lub klikając prawym przyciskiem myszy i wybierając polecenie Właściwości. Niektóre właściwości są tylko do odczytu, a niektóre z nich można modyfikować. Zazwyczaj jednak nie trzeba ręcznie modyfikować tych właściwości.

Właściwości odwołania ActiveX

Właściwości odwołania ActiveX są dostępne tylko dla odwołań do składników COM. Te właściwości są wyświetlane tylko po wybraniu składnika COM w okienku Odwołania . Właściwości nie można modyfikować.

Pełna ścieżka kontrolki

Wyświetla ścieżkę katalogu kontrolki, do których odwołuje się odwołanie.
Identyfikator GUID kontrolki

Wyświetla identyfikator GUID kontrolki ActiveX.
Kontrola wersji

Wyświetla wersję przywołytowanej kontrolki ActiveX.
Nazwa biblioteki typów

Wyświetla nazwę biblioteki typów, do których odwołuje się odwołanie.
Narzędzie otoki

Wyświetla narzędzie używane do kompilowania zestawu międzyoperacyjnego z biblioteki COM lub kontrolki ActiveX.

Właściwości odwołania do zestawu (C++/CLI)

Właściwości odwołania do zestawu są dostępne tylko w przypadku odwołań do zestawów .NET Framework w projektach C++/CLI. Te właściwości są wyświetlane tylko po wybraniu zestawu .NET Framework w okienku Odwołania . Właściwości nie można modyfikować.

Ścieżka względna

Wyświetla ścieżkę względną z katalogu projektu do przywoływnego zestawu.

Właściwości kompilacji

Następujące właściwości są dostępne w różnych rodzajach odwołań. Umożliwiają one określenie sposobu kompilowania przy użyciu odwołań.

Kopiuj lokalnie

Określa, czy podczas kompilacji ma być automatycznie kopiowany zestaw, do których się odwołujesz, do lokalizacji docelowej.
Kopiowanie lokalnych zestawów satelickich (C++/CLI)

Określa, czy podczas kompilacji mają być automatycznie kopiowane zestawy satelitarne zestawu, do których odwołuje się zestaw. Używane tylko wtedy, gdy wartość Kopiuj lokalnie to true.
Dokumentacja danych wyjściowych zestawu

Określa, że ten zestaw jest używany w procesie kompilacji. Jeśli truezestaw zostanie użyty w wierszu polecenia kompilatora podczas kompilacji.

Właściwości referencyjne projektu do projektu

Poniższe właściwości definiują odwołanie do projektu z projektu wybranego w okienku Odwołania do innego projektu w tym samym rozwiązaniu. Aby uzyskać więcej informacji, zobacz Zarządzanie odwołaniami w projekcie.

Zależności biblioteki łączy

Gdy ta właściwość ma wartość True, system projektu łączy pliki LIB generowane przez niezależny projekt w projekcie zależnym. Zazwyczaj należy określić wartość True.
Identyfikator projektu

Jednoznacznie identyfikuje niezależny projekt. Wartość właściwości jest wewnętrznym identyfikatorem GUID systemu, który nie można modyfikować.
Korzystanie z danych wejściowych zależności biblioteki

Jeśli ta właściwość ma wartość False, system projektu nie będzie łączyć plików OBJ dla biblioteki, którą niezależny projekt generuje w projekcie zależnym. Dlatego ta wartość wyłącza łączenie przyrostowe. Zazwyczaj należy określić wartość False , ponieważ kompilowanie aplikacji może zająć dużo czasu, jeśli istnieje wiele niezależnych projektów.

Właściwości odwołania tylko do odczytu (COM i .NET)

Następujące właściwości istnieją w odwołaniach do zestawów COM i .NET i nie można ich modyfikować.

Nazwa zestawu

Wyświetla nazwę zestawu, do których odwołuje się zestaw.
Kultury

Wyświetla kulturę wybranego odwołania.
Opis

Wyświetla opis wybranego odwołania.
Pełna ścieżka

Wyświetla ścieżkę katalogu przywołytowanego zestawu.
Tożsamość

W przypadku zestawów programu .NET Framework zostanie wyświetlona pełna ścieżka. W przypadku składników COM wyświetla identyfikator GUID.
Etykieta

Wyświetla etykietę odwołania.
Nazwa/nazwisko

Wyświetla nazwę odwołania.
Token klucza publicznego

Wyświetla token klucza publicznego używany do identyfikowania przywołytowanego zestawu.
Silna nazwa

true jeśli przywołyny zestaw ma silną nazwę. Silny nazwany zestaw ma unikatową wersję.
Wersja

Wyświetla wersję przywołytowanego zestawu.

Zobacz też

Odwołanie do strony właściwości projektu języka C++
Ustawianie właściwości kompilacji i kompilatora języka C++ w programie Visual Studio