Korzystanie z bibliotek i składników

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:

• vcpkg w projektach CMake
• Instalowanie i używanie pakietów za pomocą narzędzia CMake w programie Visual Studio
• vcpkg w projektach MSBuild
• Samouczek: instalowanie i używanie pakietów za pomocą programu MSBuild w programie Visual Studio

Korzystanie z bibliotek statycznych

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

1. #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źć.
2. 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:

1. Kliknij prawym przyciskiem myszy węzeł projektu aplikacji w Eksplorator rozwiązań, a następnie wybierz polecenie Właściwości.
2. 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.
3. 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.

1. 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).
2. 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 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.

• Kultura

  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