Przewodnik: kompilowanie programu C++/CLI przeznaczonego dla środowiska CLR w programie Visual Studio

Artykuł
10/12/2023

Za pomocą języka C++/CLI można tworzyć programy języka C++, które używają klas platformy .NET, a także natywnych typów języka C++. Język C++/CLI jest przeznaczony do użycia w aplikacjach konsolowych i w bibliotekach DLL, które opakowuje natywny kod C++ i udostępnia je z programów platformy .NET. Aby utworzyć interfejs użytkownika systemu Windows na podstawie platformy .NET, użyj języka C# lub Visual Basic.

W tej procedurze można wpisać własny program C++ lub użyć jednego z przykładowych programów. Przykładowy program używany w tej procedurze tworzy plik tekstowy o nazwie textfile.txt i zapisuje go w katalogu projektu.

Wymagania wstępne

Znajomość podstaw języka C++.
W programie Visual Studio 2017 lub nowszym obsługa języka C++/CLI jest składnikiem opcjonalnym. Aby go zainstalować, otwórz Instalator programu Visual Studio z menu Start systemu Windows. Upewnij się, że kafelek Programowanie aplikacji klasycznych w języku C++ jest zaznaczone, a w sekcji Składniki opcjonalne sprawdź również obsługę języka C++/CLI.

Tworzenie nowego projektu

Poniższe kroki różnią się w zależności od używanej wersji programu Visual Studio. Aby zapoznać się z dokumentacją preferowanej wersji programu Visual Studio, użyj kontrolki selektora wersji . Znajduje się on w górnej części spisu treści na tej stronie.

Aby utworzyć projekt C++/CLI w programie Visual Studio

W Eksplorator rozwiązań kliknij prawym przyciskiem myszy u góry, aby otworzyć okno dialogowe Tworzenie nowego projektu.
W górnej części okna dialogowego wpisz CLR w polu wyszukiwania, a następnie wybierz pozycję CLR Empty Project (.NET Framework) z listy wyników.
Wybierz przycisk Utwórz, aby utworzyć projekt.

Aby utworzyć projekt C++/CLI w programie Visual Studio 2017

Tworzenie nowego projektu. W menu Plik wskaż polecenie Nowy, a następnie kliknij pozycję Projekt.
W typach projektów Visual C++ kliknij pozycję CLR, a następnie kliknij pozycję CLR Empty Project (Pusty projekt CLR).
Wpisz nazwę projektu. Domyślnie rozwiązanie, które zawiera projekt, ma taką samą nazwę jak nowy projekt, ale możesz wprowadzić inną nazwę. Jeśli chcesz, możesz wprowadzić inną lokalizację projektu.
Kliknij przycisk OK , aby utworzyć nowy projekt.

Aby utworzyć projekt C++/CLI w programie Visual Studio 2015

Tworzenie nowego projektu. W menu Plik wskaż polecenie Nowy, a następnie kliknij pozycję Projekt.
W typach projektów Visual C++ kliknij pozycję CLR, a następnie kliknij pozycję CLR Empty Project (Pusty projekt CLR).
Wpisz nazwę projektu. Domyślnie rozwiązanie, które zawiera projekt, ma taką samą nazwę jak nowy projekt, ale możesz wprowadzić inną nazwę. Jeśli chcesz, możesz wprowadzić inną lokalizację projektu.
Kliknij przycisk OK , aby utworzyć nowy projekt.

Dodawanie pliku źródłowego

Jeśli Eksplorator rozwiązań nie jest widoczna, kliknij Eksplorator rozwiązańw menu Widok.
Dodaj nowy plik źródłowy do projektu:
- Kliknij prawym przyciskiem myszy folder Pliki źródłowe w Eksplorator rozwiązań, wskaż polecenie Dodaj, a następnie kliknij pozycję Nowy element.
- Kliknij pozycję Plik C++ (cpp) i wpisz nazwę pliku, a następnie kliknij przycisk Dodaj.
Plik cpp zostanie wyświetlony w folderze Pliki źródłowe w Eksplorator rozwiązań, a w oknie z kartą zostanie wpisany odpowiedni kod w tym pliku.
Kliknij nowo utworzoną kartę w programie Visual Studio i wpisz prawidłowy program Visual C++ lub skopiuj i wklej jeden z przykładowych programów.

Na przykład możesz użyć przykładowego programu How to: Write a Text File (C++/CLI) (w węźle Obsługa plików i We/Wy przewodnika programowania).

Jeśli używasz przykładowego programu, zwróć uwagę, że używasz gcnew słowa kluczowego zamiast new podczas tworzenia obiektu .NET i zwraca gcnew uchwyt (^) zamiast wskaźnika (*):

StreamWriter^ sw = gcnew StreamWriter(fileName);

Aby uzyskać więcej informacji na temat składni języka C++/interfejsu wiersza polecenia, zobacz Rozszerzenia składników dla platform środowiska uruchomieniowego.
W menu Kompilacja kliknij pozycję Kompiluj rozwiązanie.

W oknie Dane wyjściowe są wyświetlane informacje o postępie kompilacji, takie jak lokalizacja dziennika kompilacji i komunikat wskazujący stan kompilacji.

Jeśli wprowadzisz zmiany i uruchomisz program bez wykonywania kompilacji, okno dialogowe może wskazywać, że projekt jest nieaktualny. Zaznacz pole wyboru w tym oknie dialogowym przed kliknięciem przycisku OK , jeśli chcesz, aby program Visual Studio zawsze używał bieżących wersji plików zamiast monitować użytkownika za każdym razem, gdy kompiluje aplikację.
W menu Debugowanie kliknij przycisk Start bez debugowania.
Jeśli użyto przykładowego programu, po uruchomieniu programu zostanie wyświetlone okno polecenia wskazujące, że plik tekstowy został utworzony.

Plik tekstowy textfile.txt znajduje się teraz w katalogu projektu. Ten plik można otworzyć przy użyciu Notatnik.

Uwaga

Wybranie pustego szablonu projektu CLR powoduje automatyczne ustawienie opcji kompilatora /clr . Aby to sprawdzić, kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań i kliknij polecenie Właściwości, a następnie zaznacz opcję Obsługa środowiska uruchomieniowego języka wspólnego w węźle Ogólne właściwości konfiguracji.

Zobacz też

Dokumentacja języka C++
Projekty i systemy kompilacji