Exemplarische Vorgehensweise: Kompilieren eines C++/CLI-Programms, das auf die CLR in Visual Studio ausgerichtet ist

Artikel
10/12/2023

Mithilfe von C++/CLI können Sie C++-Programme erstellen, die .NET-Klassen sowie systemeigene C++-Typen verwenden. C++/CLI ist für die Verwendung in Konsolenanwendungen und in DLLs vorgesehen, die systemeigenen C++-Code umschließen und über .NET-Programme zugänglich machen. Verwenden Sie C# oder Visual Basic, um eine Windows-Benutzeroberfläche basierend auf .NET zu erstellen.

Für dieses Verfahren können Sie Ihr eigenes C++-Programm eingeben oder eines der Beispielprogramme verwenden. Das Beispielprogramm, das für diese Vorgehensweise verwendet wird, erstellt eine Textdatei namens „textfile.txt“, die im Projektverzeichnis gespeichert wird.

Voraussetzungen

Grundlegende Kenntnisse der Programmiersprache C++.
In Visual Studio 2017 und höher ist die C++/CLI-Unterstützung eine optionale Komponente. Um sie zu installieren, öffnen Sie den Visual Studio-Installer aus dem Windows Menü . Stellen Sie sicher, dass die Desktopentwicklung mit C++-Kachel aktiviert ist, und überprüfen Sie im Abschnitt "Optionale Komponenten" auch die C++/CLI-Unterstützung.

Ein neues Projekt erstellen

Die folgenden Schritte variieren leicht, je nachdem, welche Version von Visual Studio Sie verwenden. Um die Dokumentation für Ihre bevorzugte Version von Visual Studio anzuzeigen, verwenden Sie das Auswahlsteuerelement Version. Es befindet sich am Anfang des Inhaltsverzeichnisses auf dieser Seite.

So erstellen Sie ein C++/CLI-Projekt in Visual Studio

Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste oben, um das Dialogfeld "Neues Projekt erstellen" zu öffnen.
Geben Sie oben im Dialogfeld CLR in das Suchfeld ein, und wählen Sie dann in der Ergebnisliste CLR Empty Project (.NET Framework) aus.
Klicken Sie auf die Schaltfläche Erstellen, um das Projekt zu erstellen.

So erstellen Sie ein C++/CLI-Projekt in Visual Studio 2017

Erstelle ein neues Projekt. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Klicken Sie in den Visual C++-Projekttypen auf CLR, und klicken Sie dann auf leeres CLR-Projekt.
Geben Sie einen Projektnamen ein. Standardmäßig erhält die Projektmappe, in der das Projekt enthalten ist, den gleichen Namen wie das neue Projekt. Sie können jedoch auch einen anderen Namen eingeben. Wenn Sie möchten, können Sie auch einen anderen Speicherort für das Projekt angeben.
Klicken Sie auf OK, um das neue Projekt zu erstellen.

So erstellen Sie ein C++/CLI-Projekt in Visual Studio 2015

Erstelle ein neues Projekt. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.
Klicken Sie in den Visual C++-Projekttypen auf CLR, und klicken Sie dann auf leeres CLR-Projekt.
Geben Sie einen Projektnamen ein. Standardmäßig erhält die Projektmappe, in der das Projekt enthalten ist, den gleichen Namen wie das neue Projekt. Sie können jedoch auch einen anderen Namen eingeben. Wenn Sie möchten, können Sie auch einen anderen Speicherort für das Projekt angeben.
Klicken Sie auf OK, um das neue Projekt zu erstellen.

Hinzufügen einer Quelldatei

Wenn der Projektmappen-Explorer nicht angezeigt wird, klicken Sie im Menü Ansicht auf Projektmappen-Explorer.
Fügen Sie dem Projekt eine neue Quelldatei hinzu:
- Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Ordner Quelldateien, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neues Element.
- Klicken Sie auf C++-Datei (.cpp), geben Sie einen Dateinamen ein, und klicken Sie dann auf Hinzufügen.
Die CPP-Datei wird im Ordner Quelldateien im Projektmappen-Explorer angezeigt. Au0erdem wird ein Fenster im Registerkartenformat angezeigt, in dem Sie den Code eingeben können, den Sie in diese Datei einfügen möchten.
Klicken Sie in Visual Studio in die neu erstellte Registerkarte, und geben Sie ein gültiges Visual C++-Programm ein, oder kopieren Sie eines der Beispielprogramme und fügen es ein.

Sie können beispielsweise das Beispielprogramm How to: Write a Text File (C++/CLI) (Vorgehensweise: Schreiben einer Textdatei (C++/CLI)) verwenden (im Knoten Dateibehandlung und E/A des Programmierhandbuchs).

Beachten Sie, wenn Sie das Beispielprogramm verwenden, dass Sie das Schlüsselwort gcnew anstelle von new beim Erstellen eines .NET-Objekts verwenden, und dass gcnew ein Handle (^) anstelle eines Pointers (*) zurückgibt:

StreamWriter^ sw = gcnew StreamWriter(fileName);

Weitere Informationen zur C++/CLI-Syntax finden Sie unter Komponentenerweiterungen für Laufzeitplattformen.
Klicken Sie im Menü Erstellen auf Projektmappe erstellen.

Im Ausgabefenster werden Informationen zum Kompilierungsprozess angezeigt, z.B. der Speicherort des Buildprotokolls und eine Meldung über den Buildstatus.

Wenn Sie Änderungen vornehmen und das Programm ausführen, ohne einen Buildvorgang auszuführen, gibt ein Dialogfeld möglicherweise an, dass das Projekt nicht mehr aktuell ist. Aktivieren Sie in diesem Dialogfeld das Kontrollkästchen, bevor Sie auf OK klicken, wenn Sie möchten, dass Visual Studio immer die aktuellen Versionen von Dateien verwendet, anstatt Sie jedes zur Eingabe aufzufordern, wenn die Anwendung erstellt wird.
Klicken Sie im Menü Debuggen auf Starten ohne Debuggen.
Wenn Sie das Beispielprogramm verwendet haben und das Programm ausführen, wird ein Befehlsfenster angezeigt, das angibt, dass die Textdatei erstellt wurde.

Die Textdatei textfile.txt befindet sich nun in Ihrem Projektverzeichnis. Sie können diese Datei mit dem Editor öffnen.

Hinweis

Durch Auswählen der leeren CLR-Projektvorlage wird automatisch die Compileroption /clr festgelegt. Klicken Sie zum Überprüfen mit der rechten Maustaste auf das Projekt im Projektmappen-Explorer, klicken Sie auf Eigenschaften, und überprüfen Sie dann die Option Common Language Runtime-Unterstützung im Knoten Allgemein der Konfigurationseigenschaften.

Siehe auch

C++-Programmiersprachenreferenz
Projekte und Buildsysteme