Ausführen eines C#-Programms in Visual Studio

Die Vorgehensweise beim Ausführen eines Programms hängt vom Ausgangspunkt und der Art des Programms sowie davon ab, ob Sie das Programm mit einem Debugger ausführen möchten oder nicht. Im einfachsten Fall können Sie wie folgt ein offenes Projekt in Visual Studio erstellen und ausführen:

• Drücken Sie F5, wählen Sie im Visual Studio-Menü Debuggen>Mit Debugging starten aus, oder klicken Sie auf den grünen Startpfeil und den Projektnamen auf der Symbolleiste in Visual Studio.
• Wenn Sie das Programm ohne Debuggen ausführen möchten, drücken Sie STRG+F5, oder wählen Sie im Visual Studio-Menü Debuggen>Ohne Debuggen starten aus.

Projekt als Ausgangspunkt

Sie können ein C#-Projekt oder eine CSPROJ-Datei ausführen, wenn es sich um ein ausführbares Programm handelt. Wenn das Projekt eine C#-Datei mit einer Main-Methode enthält und die Ausgabe eine ausführbare Datei oder EXE-Datei ist, wird es wahrscheinlich ausgeführt, wenn es erfolgreich erstellt wurde. Neuere Versionen von C# benötigen keine Main-Methode. Stattdessen beginnen Programmausführungen mit Anweisungen auf oberster Ebene. Weitere Informationen finden Sie unter Programme ohne „Main“-Methoden.

1. Wenn Ihr Programmcode sich bereits in einem Visual Studio-Projekt befindet, öffnen Sie das Projekt. Hierzu können Sie im Windows Datei-Explorer auf die CSPROJ-Datei doppelklicken oder tippen. Alternativ können Sie in Visual Studio auf Open a project (Projekt öffnen) klicken, nach der CSPROJ-Datei suchen und auf die Datei klicken.

2. Wenn das Projekt in Visual Studio geladen wurde und Ihre Visual Studio-Projektmappe über mehr als ein Projekt verfügt, legen Sie unbedingt das Projekt mit der Main-Methode als Startprojekt fest. Klicken Sie zum Festlegen des Startprojekts mit der rechten Maustaste auf den Projektnamen oder Knoten im Projektmappen-Explorer, und klicken Sie im Kontextmenü auf Als Startprojekt festlegen.

   

3. Drücken Sie STRG+F5, klicken Sie im Hauptmenü auf Debuggen>Ohne Debuggen starten, oder klicken Sie auf die grüne Startschaltfläche, um das Programm auszuführen.

   Visual Studio versucht nun, Ihr Projekt zu erstellen und auszuführen. Unten auf dem Visual Studio-Bildschirm wird im Fenster Ausgabe die Buildausgabe angezeigt, und im Fenster Fehlerliste sehen Sie die Buildfehler.

   Wenn das Projekt erfolgreich erstellt wurde, wird die App dem Projekttyp entsprechend ausgeführt. Konsolen-Apps werden in einem Terminalfenster ausgeführt, Windows-Desktop-Apps werden in einem neuen Desktopfenster gestartet, und Web-Apps werden in einem von IIS Express gehosteten Browser gestartet.

Code als Ausgangspunkt

Wenn Ihr Ausgangspunkt eine Codeliste, eine Codedatei oder eine geringe Anzahl von Dateien ist, sollten Sie sich zunächst vergewissern, dass es sich bei dem Code um ein ausführbares Programm aus einer vertrauenswürdigen Quelle handelt. Jede App mit einer Main-Methode ist wahrscheinlich ein ausführbares Programm, aber mit der aktuellen Version von C# können auch Programme ohne Main-Methoden mit Anweisungen auf oberster Ebene ausgeführt werden. Sie können die Vorlage „Konsolenanwendung“ verwenden, um ein Projekt zu erstellen, mit dem Sie in Visual Studio mit der App arbeiten können.

Codelisten für eine einzelne Datei

1. Starten Sie Visual Studio, und öffnen Sie ein leeres C#-Konsolenanwendungsprojekt.
2. Ersetzen Sie den gesamten Code in der CS-Datei durch den Inhalt Ihrer Codeliste oder Datei.
3. Benennen Sie die CS-Projektdatei so um, dass ihr Name dem Codedateinamen entspricht.

Mehrere Codelisten oder Dateien auf einem Datenträger

1. Starten Sie Visual Studio, und erstellen Sie ein neues Projekt mit dem richtigen Projekttyp. Wenn Sie sich nicht sicher sind, verwenden Sie die C#-Konsolenanwendung.
2. Ersetzen Sie im neuen Projekt den gesamten Code in der Projektcodedatei durch den Inhalt Ihrer ersten Codeliste oder Datei.
3. Benennen Sie die Projektcodedatei so um, dass ihr Name dem Codedateinamen entspricht.
4. Gehen Sie bei den restlichen Codedateien wie folgt vor:
   1. Klicken Sie mit der rechten Maustaste auf den Projektknoten im Projektmappen-Explorer, und klicken Sie dann auf Hinzufügen> Vorhandenes Element, oder wählen Sie das Projekt aus, und drücken Sie auf UMSCHALT+ALT+A.
   2. Navigieren Sie zur Codedatei, und wählen Sie sie aus, um sie in das Projekt zu importieren.

Mehrere Dateien in einem Ordner

Wenn Sie über einen Ordner mit vielen Dateien verfügen, suchen Sie zunächst nach einer Projekt- oder Projektmappendatei. Mit Visual Studio erstellte Programme verfügen über Projekt- und Projektmappendateien. Suchen Sie im Windows Datei-Explorer nach Dateien mit der Erweiterung CSPROJ oder SLN. Doppelklicken Sie auf die CSPROJ-Datei, um sie in Visual Studio zu öffnen. Weitere Informationen finden Sie unter Projekt als Ausgangspunkt.

Wenn der Code aus einer anderen Entwicklungsumgebung stammt, gibt es keine Projektdatei. Öffnen Sie den Ordner, indem Sie in Visual Studio auf Öffnen>Ordner klicken. Weitere Informationen finden Sie im Artikel Entwickeln von Code in Visual Studio ohne Projekte oder Projektmappen.

GitHub- oder Azure DevOps-Repository als Ausgangspunkt

Wenn sich der Code, den Sie ausführen möchten, in einem GitHub- oder Azure DevOps-Repository befindet, können Sie das Projekt mithilfe von Visual Studio direkt über das Repository öffnen. Weitere Informationen finden Sie im Artikel Tutorial: Öffnen eines Projekts von einem Repository aus.

Ausführen des Programms

Klicken Sie in Visual Studio auf der Symbolleiste auf die grüne Startschaltfläche, oder drücken Sie F5 oder STRG+F5, um mit dem Erstellen des Programms zu beginnen. Wenn Sie die Startschaltfläche oder F5 verwenden, wird bei der Ausführung der Debugger verwendet.

Visual Studio versucht, den Code in Ihrem Projekt zu kompilieren und auszuführen. Wenn das Projekt nicht erfolgreich erstellt wird, finden Sie in den folgenden Abschnitten einige Möglichkeiten, dieses Problem zu beheben.

Problembehandlung

Möglicherweise enthält Ihr Code Fehler. Eine weitere Möglichkeit wäre, dass der Code richtig ist, aber von fehlenden Assemblys oder NuGet-Paketen abhängig ist oder für eine andere Version von .NET erstellt wurde. In diesen Fällen können Sie das Buildproblem möglicherweise leicht beheben.

Hinzufügen von Verweisen

Damit eine ordnungsgemäße Erstellung erfolgen kann, muss der Code fehlerfrei sein und die richtigen Verweise auf Bibliotheken oder andere Abhängigkeiten enthalten. Rote Unterschlängelungen in Code oder Einträge in der Fehlerliste weisen sogar vor dem Kompilieren und Ausführen des Programms auf Fehler hin. Wenn die Fehler auf nicht aufgelöste Namen zurückzuführen sind, müssen Sie wahrscheinlich einen Verweis oder eine using-Anweisung oder sogar beides hinzufügen. Wenn der Code auf fehlende Assemblys oder NuGet-Pakete verweist, müssen Sie diese Verweise im Projekt hinzufügen.

Visual Studio unterstützt Sie bei der Identifizierung fehlender Verweise. Wenn ein Name nicht aufgelöst ist, wird im Editor ein Glühbirnensymbol angezeigt. Klicken Sie auf das Glühbirnensymbol, um Vorschläge für die Behebung des Problems anzuzeigen. Fehler könnten durch folgende Maßnahmen behoben werden:

• Hinzufügen einer using-Anweisung
• Hinzufügen eines Verweises auf eine Assembly
• Installieren eines NuGet-Pakets

Hinzufügen einer using-Anweisung

Im Folgenden sehen Sie ein Beispiel für eine fehlende using-Anweisung. Sie können am Anfang der Codedatei using System; hinzufügen, um den nicht aufgelösten Namen Console aufzulösen:

Neuere Versionen von C# unterstützen die implizite Verwendung von Anweisungen für einige häufig verwendete Namespaces. Wenn Sie diese Option beim Erstellen eines Projekts gewählt haben, benötigen Sie sie daher nicht.

Hinzufügen eines Verweises auf eine Assembly

Bei .NET-Verweisen kann es sich um Verweise auf Assemblys oder NuGet-Pakete handeln. Im Quellcode erklärt der Herausgeber oder Autor in der Regel, welche Assemblys der Code benötigt und von welchen Paketen er abhängig ist. Gehen Sie wie folgt vor, um in einem Projekt manuell einen Verweis hinzuzufügen: Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verweise, und klicken Sie dann auf Verweis hinzufügen. Suchen Sie im Verweis-Manager nach der erforderlichen Assembly, und fügen Sie sie hinzu.

Befolgen Sie die Anweisungen im Artikel Vorgehensweise: Hinzufügen und Entfernen von Verweisen mit dem Verweis-Manager, um Assemblys zu finden und Verweise hinzuzufügen.

Hinzufügen eines NuGet-Pakets

Wenn Visual Studio ein fehlendes NuGet-Paket erkennt, wird ein Glühbirnensymbol angezeigt, über das Sie das Paket installieren können:

Wenn das Problem dadurch nicht behoben werden kann oder Visual Studio das Paket nicht finden kann, suchen Sie online nach dem Paket. Weitere Informationen finden Sie im Artikel Schnellstart: Installieren und Verwenden eines Pakets in Visual Studio (nur Windows).

Verwenden der richtigen .NET-Version

Da die verschiedenen Versionen des .NET Framework eine gewisse Abwärtskompatibilität aufweisen, kann für eine ältere Version des Framework geschriebener Code möglicherweise ohne Änderungen in einer neueren Version ausgeführt werden. Gelegentlich müssen Sie jedoch für eine bestimmte .NET Framework-Version entwickeln. Möglicherweise müssen Sie eine bestimmte Version des .NET Framework oder von .NET Core installieren. Weitere Informationen finden Sie im Artikel Ändern von Visual Studio durch Hinzufügen oder Entfernen von Arbeitsauslastungen und Komponenten.

Weitere Informationen zum Ändern der verwendeten .NET Framework-Version finden Sie unter Ändern des Zielframeworks. Weitere Informationen zum Troubleshooting finden Sie unter Problembehandlung bei .NET Framework-Zielversionsfehlern.

Nächste Schritte

• Wenn Sie die Entwicklungsumgebung von Visual Studio näher kennenlernen möchten, lesen Sie sich den Artikel Willkommen in der Visual Studio-IDE durch.
• Erstellen Sie Ihre erste C#-App.