Freigeben über


Nutzungsausnahmen

In C# werden Fehler im Programm zur Laufzeit mithilfe von sogenannten Ausnahmen durch das Programm weitergegeben. Ausnahmen werden von Code ausgelöst, der auf einen Fehler stößt. Sie werden von Code abgefangen, der den Fehler beheben kann. Ausnahmen können durch die .NET-Runtime oder durch Code in einem Programm ausgelöst werden. Sobald eine Ausnahme ausgelöst wird, wird sie in der Aufrufliste nach oben weitergegeben, bis eine catch-Anweisung für die Ausnahme gefunden wird. Nicht abgefangene Ausnahmen werden von einem generischen Ausnahmehandler behandelt, der vom System bereitgestellt wird, das ein Dialogfeld anzeigt.

Ausnahmen werden von Klassen dargestellt, die von Exception abgeleitet sind. Diese Klasse bestimmt den Typ der Ausnahme und enthält Eigenschaften, die über Details zur Ausnahme verfügen. Das Auslösen einer Ausnahme umfasst das Erstellen einer Instanz einer von einer Ausnahme abgeleiteten Klasse, das optionale Konfigurieren von Eigenschaften der Ausnahme und das Auslösen des Objekts mithilfe des Schlüsselworts throw. Zum Beispiel:

class CustomException : Exception
{
    public CustomException(string message)
    {
    }
}
private static void TestThrow()
{
    throw new CustomException("Custom exception in TestThrow()");
}

Nachdem eine Ausnahme ausgelöst wird, überprüft die Runtime die aktuelle Anweisung, um festzustellen, ob sie sich in einem try-Block befindet. Falls dies der Fall ist, werden alle mit dem try-Block verknüpften catch-Blöcke überprüft, um festzustellen, ob sie die Ausnahme abfangen können. Catch-Blöcke geben normalerweise Ausnahmetypen an; wenn der Typ des catch-Blocks der gleiche Typ ist wie die Ausnahme oder die Basisklasse der Ausnahme, kann der catch-Block die Methode behandeln. Zum Beispiel:

try
{
    TestThrow();
}
catch (CustomException ex)
{
    System.Console.WriteLine(ex.ToString());
}

Wenn sich die Anweisung, die eine Ausnahme auslöst, nicht innerhalb eines try-Blocks befindet, oder der try-Block, der sie umfasst, über keinen übereinstimmenden catch-Block verfügt, überprüft die Runtime die aufrufende Methode auf eine try-Anweisung und catch-Blöcke. Die Runtime geht die Aufrufliste weiter nach oben durch und sucht nach einem kompatiblen catch-Block. Nachdem der catch-Block gefunden und ausgeführt wurde, wird die Steuerung an die nächste Anweisung nach diesem catch-Block weitergegeben.

Eine try-Anweisung kann mehr als einen catch-Block enthalten. Die erste catch-Anweisung, die die Ausnahme behandelt, wird ausgeführt. Alle folgenden catch-Anweisungen werden ignoriert, selbst wenn sie kompatibel sind. Sortieren Sie Catch-Blöcke immer vom spezifischsten (oder am meisten abgeleiteten) zum am wenigsten spezifischen Element. Zum Beispiel:

using System;
using System.IO;

namespace Exceptions
{
    public class CatchOrder
    {
        public static void Main()
        {
            try
            {
                using (var sw = new StreamWriter("./test.txt"))
                {
                    sw.WriteLine("Hello");
                }
            }
            // Put the more specific exceptions first.
            catch (DirectoryNotFoundException ex)
            {
                Console.WriteLine(ex);
            }
            catch (FileNotFoundException ex)
            {
                Console.WriteLine(ex);
            }
            // Put the least specific exception last.
            catch (IOException ex)
            {
                Console.WriteLine(ex);
            }
            Console.WriteLine("Done");
        }
    }
}

Bevor der catch-Block ausgeführt wird prüft die Runtime auf finally-Blöcke. Finally-Blöcke ermöglichen dem Programmierer, mehrdeutige Zustände zu bereinigen, die möglicherweise von einem abgebrochenen try-Block übrig sind, oder externe Ressourcen freizugeben (z. B. Grafikhandles, Datenbankverbindungen oder Dateistreams), ohne auf den Garbage Collector in der Runtime zum Fertigstellen der Objekte zu warten. Zum Beispiel:

static void TestFinally()
{
    FileStream? file = null;
    //Change the path to something that works on your machine.
    FileInfo fileInfo = new System.IO.FileInfo("./file.txt");

    try
    {
        file = fileInfo.OpenWrite();
        file.WriteByte(0xF);
    }
    finally
    {
        // Closing the file allows you to reopen it immediately - otherwise IOException is thrown.
        file?.Close();
    }

    try
    {
        file = fileInfo.OpenWrite();
        Console.WriteLine("OpenWrite() succeeded");
    }
    catch (IOException)
    {
        Console.WriteLine("OpenWrite() failed");
    }
}

Wenn WriteByte() eine Ausnahme auslöst, schlägt der Code im zweiten try-Block fehl, der versucht, die Datei wieder zu öffnen, wenn file.Close() nicht aufgerufen wird. Die Datei bleibt gesperrt. Da finally-Blocke ausgeführt werden, selbst wenn eine Ausnahme ausgelöst wird, ermöglicht es der finally-Block im vorherigen Beispiel, dass die Datei korrekt geschlossen wird und trägt so zur Fehlervermeidung bei.

Wenn in der Aufrufliste kein kompatibler catch-Block gefunden wird, nachdem eine Ausnahme ausgelöst wird, tritt eine der folgenden Situationen auf:

  • Wenn die Ausnahme sich in einem Finalizer befindet, wird der Finalizer abgebrochen und der Basisfinalizer (sofern vorhanden) aufgerufen.
  • Wenn die Aufrufliste einen statischen Konstruktor oder einen statischen Feldinitialisierer enthält, wird TypeInitializationException ausgelöst und die ursprüngliche Ausnahme der InnerException-Eigenschaft der neuen Ausnahme zugewiesen.
  • Wenn der Anfang des Threads erreicht wird, wird der Thread beendet.