HOWTO · Csharp

Konsolenanwendung beenden in C#

Beenden Sie eine C#-Konsolenanwendung nach Abschluss ihrer Arbeit durch eine Rückgabe aus Main. Muss der Prozess sofort aus einer anderen Methode beendet werden, rufen Sie die Methode Environment.Exit(int) auf.

Auf dieser Seite

Um eine C#-Konsolenanwendung nach Abschluss ihrer Arbeit zu beenden, kehren Sie aus Main zurück. Rufen Sie Environment.Exit() nur auf, wenn der Prozess sofort aus einer anderen Methode beendet werden muss. Eine Ganzzahl, die aus Main zurückgegeben oder an Environment.Exit(int) übergeben wird, bestimmt den Prozess-Exitcode; Konsolentext ist davon getrennt.

Anwendung durch Rückgabe aus Main beenden

Eine return-Anweisung beendet die aktuelle Methode. Beendet sie Main, ist die normale Ausführung der Anwendung abgeschlossen; Anweisungen nach der Rückgabe werden nicht ausgeführt. Eine Rückgabe aus einer verschachtelten Methode übergibt die Steuerung lediglich an deren Aufrufer zurück und beendet die Anwendung daher nicht selbst. Für den regulären Abschluss sollten Sie aus Main zurückkehren: Das folgt dem normalen Kontrollfluss und ermöglicht die Ausführung umgebender finally-Blöcke sowie die Ressourcenbereinigung.

Ein void Main() kann mit return; ohne Rückgabewert beendet werden. Ein int Main() kann einen Exitcode zurückgeben. Dieses vollständige Beispiel gibt eine Statuszeile aus und liefert den üblichen Erfolgscode zurück. Die bereitgestellte Laufzeitbeobachtung ergab Work completed. und den Exitcode 0.

Führen Sie dieses Beispiel aus:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

using System;

class Program
{
    static int Main()
    {
        Console.WriteLine("Work completed.");
        return 0;
    }
}
Work completed.

return 0; beendet Main, und das Betriebssystem oder der aufrufende Prozess erhält den Wert 0. Wenn Sie einen Fehler signalisieren müssen, geben Sie stattdessen einen Wert ungleich null zurück. Die genaue Bedeutung jedes solchen Werts legt Ihr Programm oder dessen Aufrufer fest.

Mit Environment.Exit() aus jeder Methode beenden

Environment.Exit(int) kann den Prozess aus einer anderen Methode als Main beenden. Die Methode beendet den Prozess sofort mit dem übergebenen ganzzahligen Exitcode und kehrt nicht zum Aufrufer zurück. Verwenden Sie sie nur, wenn ein reguläres Zurückkehren nicht möglich ist, etwa bei einem bewusst sofortigen Abbruch. Bei gewöhnlicher Fehlerbehandlung sollten Sie das Problem im Allgemeinen melden und aus Main einen passenden Code zurückgeben.

Dieses vollständige Beispiel ruft Environment.Exit(0) aus StopApplication auf, einer anderen Methode als Main:

Der Code und die angezeigten Bezeichnungen oder Ausgaben in diesem Abschnitt bleiben auf Englisch.

using System;

class Program
{
    static void Main()
    {
        StopApplication();
        Console.WriteLine("This line is not reached.");
    }

    static void StopApplication()
    {
        Console.WriteLine("Stopping now.");
        Environment.Exit(0);
    }
}

Der Aufruf übergibt den Exitcode 0 und beendet den Prozess, bevor StopApplication zurückkehrt. Daher wird die nächste Zeile in Main nicht erreicht. Die bereitgestellte Laufzeitbeobachtung bezieht sich auf das obige Main-Beispiel, nicht auf dieses Beispiel. Ein Aufruf wie Environment.Exit(1); übergibt stattdessen den Exitcode 1; die Ganzzahl wird an das Betriebssystem oder den aufrufenden Prozess übergeben. Eine mit Console.WriteLine ausgegebene Meldung ist davon getrennte Konsolenausgabe. Die Methode ist statisch in System.Environment definiert und kann daher in einer Datei mit using System; direkt aufgerufen werden.

Exitcode wählen und Folgen für die Bereinigung verstehen

Konventionell steht 0 für Erfolg und ein Wert ungleich null für einen Fehler. Das sind Konventionen, keine allgemeingültige Zuordnung für jede Anwendung. Dokumentieren Sie daher alle Codes, die ein Skript, ein Dienstmanager oder ein anderer Aufrufer auswerten muss. Sowohl eine Ganzzahl, die aus Main zurückgegeben wird, als auch ein Aufruf von Environment.Exit(int) übermittelt einen Prozess-Exitcode. Keiner der beiden Werte wird automatisch ausgegeben. Wenn eine Person eine Erklärung sehen soll, geben Sie zusätzlich eine Diagnosemeldung aus.

Geben Sie vorzugsweise aus Main zurück, wenn das Programm regulär beendet werden kann. Bei einer normalen Methodenrückgabe können finally-Blöcke ausgeführt werden, wenn die Steuerung die jeweiligen try-Anweisungen verlässt. Ressourcen in begrenzten Gültigkeitsbereichen, etwa mit using-Deklarationen, können beim Ende ihres Gültigkeitsbereichs ebenfalls freigegeben werden. Environment.Exit() beendet den Prozess sofort, ohne den normalen Abbau des Aufrufstapels auszuführen; ausstehende finally-Blöcke und die verwaltete Bereinigung werden übersprungen. Leeren oder schließen Sie wichtige Ressourcen im normalen Kontrollfluss, bevor Sie den Prozess sofort beenden, und vermeiden Sie diesen Aufruf, wenn die Bereinigung zum Erhalt von Daten oder zur Freigabe von Ressourcen nötig ist.

Prozessende von Schleifenabbrüchen, Ausnahmen und Ctrl+C unterscheiden

Eine break-Anweisung beendet die nächstgelegene Schleife oder switch-Anweisung; die Ausführung wird danach fortgesetzt. Soll das Verlassen einer Schleife auch das Programm beenden, lassen Sie die Ausführung bis zum Ende von Main laufen oder kehren Sie nach der Schleife aus Main zurück.

Beim Auslösen einer Ausnahme wird die Steuerung an einen passenden Handler übergeben. Fängt der Handler die Ausnahme ab und wird die Ausführung fortgesetzt, ist der Prozess nicht beendet. Behandeln Sie den jeweiligen Fall und wählen Sie anschließend einen regulären Rückgabepfad sowie einen passenden Exitcode, wenn die Anwendung beendet werden soll. Eine nicht behandelte Ausnahme kann einen Prozess beenden. Eine Ausnahme allein als Abkürzung zum Beenden zu verwenden, verschleiert jedoch den beabsichtigten Kontrollfluss und die Fehlerbehandlung.

Ctrl+C ist eine Abbruchanforderung über die Konsole und kein garantiert geordneter Beendigungsbefehl. Ein Programm kann sie über Console.CancelKeyPress erkennen. Ob der Prozess sofort beendet wird oder der Handler die Standardreaktion abbricht, hängt von der Ereignisbehandlung und der Hostumgebung ab. Wenn beim Abbruch eine Bereinigung nötig ist, halten Sie die Anforderung fest und lassen Sie den Hauptkontrollfluss die Arbeit beenden und regulär zurückkehren.