try-finally (C#-Referenz)try-finally (C# Reference)

Mit einem finally-Block können Sie alle Ressourcen bereinigen, die in einem try-Block belegt sind, und Sie können Code selbst dann ausführen, wenn eine Ausnahme im try-Block auftritt.By using a finally block, you can clean up any resources that are allocated in a try block, and you can run code even if an exception occurs in the try block. In der Regel werden die Anweisungen eines finally-Blocks ausgeführt, wenn die Steuerung eine try-Anweisung verlässt.Typically, the statements of a finally block run when control leaves a try statement. Die Übertragung eines Steuerelements kann infolge einer normalen Ausführung, der Ausführung einer break-, continue-, goto- oder return-Anweisung oder der Weitergabe einer Ausnahme aus der try-Anweisung auftreten.The transfer of control can occur as a result of normal execution, of execution of a break, continue, goto, or return statement, or of propagation of an exception out of the try statement.

Innerhalb einer behandelten Ausnahme ist sichergestellt, dass der zugeordnete finally-Block ausgeführt wird.Within a handled exception, the associated finally block is guaranteed to be run. Wenn die Ausnahme jedoch nicht behandelt wird, erfolgt die Ausführung des finally-Blocks je nachdem, wie der Entladevorgang für die Ausnahme ausgelöst wird.However, if the exception is unhandled, execution of the finally block is dependent on how the exception unwind operation is triggered. Das hängt wiederum davon ab, wie der Computer eingerichtet ist.That, in turn, is dependent on how your computer is set up.

Wenn eine Anwendung durch einen Ausnahmefehler beendet wird, ist es in der Regel nicht wichtig, ob der finally-Block ausgeführt wird.Usually, when an unhandled exception ends an application, whether or not the finally block is run is not important. Wenn der finally-Block jedoch Anweisungen aufweist, die auch in dieser Situation ausgeführt werden müssen, kann als Lösung ein catch-Block der try-finally-Anweisung hinzugefügt werden.However, if you have statements in a finally block that must be run even in that situation, one solution is to add a catch block to the try-finally statement. Sie können auch die Ausnahme abfangen, die möglicherweise im try-Block einer try-finally-Anweisung weiter oben in der Aufrufliste ausgelöst wird.Alternatively, you can catch the exception that might be thrown in the try block of a try-finally statement higher up the call stack. Die Ausnahme kann also in der Methode abgefangen werden, mit der die Methode mit der try-finally-Anweisung aufgerufen wird. Die Ausnahme kann aber auch in der Methode abgefangen werden, mit der diese Methode aufgerufen wird, oder in einer beliebigen Methode in der Aufrufliste.That is, you can catch the exception in the method that calls the method that contains the try-finally statement, or in the method that calls that method, or in any method in the call stack. Wenn die Ausnahme nicht abgefangen wird, wird der finally-Block je nachdem, ob vom Betriebssystem ein Entladevorgang für die Ausnahme ausgelöst wird, ausgeführt.If the exception is not caught, execution of the finally block depends on whether the operating system chooses to trigger an exception unwind operation.

BeispielExample

Im folgenden Beispiel wird eine System.InvalidCastException Ausnahme durch eine ungültige Konvertierungsanweisung verursacht.In the following example, an invalid conversion statement causes a System.InvalidCastException exception. Die Ausnahme wird nicht behandelt.The exception is unhandled.

public class ThrowTestA
{
    static void Main()
    {
        int i = 123;
        string s = "Some string";
        object obj = s;

        try
        {
            // Invalid conversion; obj contains a string, not a numeric type.
            i = (int)obj;

            // The following statement is not run.
            Console.WriteLine("WriteLine at the end of the try block.");
        }
        finally
        {
            // To run the program in Visual Studio, type CTRL+F5. Then 
            // click Cancel in the error dialog.
            Console.WriteLine("\nExecution of the finally block after an unhandled\n" +
                "error depends on how the exception unwind operation is triggered.");
            Console.WriteLine("i = {0}", i);
        }
    }
    // Output:
    // Unhandled Exception: System.InvalidCastException: Specified cast is not valid.
    //
    // Execution of the finally block after an unhandled
    // error depends on how the exception unwind operation is triggered.
    // i = 123
}

Im folgenden Beispiel wird eine Ausnahme von der TryCast-Methode in einer Methode weiter oben in der Aufrufliste abgefangen.In the following example, an exception from the TryCast method is caught in a method farther up the call stack.

public class ThrowTestB
{
    static void Main()
    {
        try
        {
            // TryCast produces an unhandled exception.
            TryCast();
        }
        catch (Exception ex)
        {
            // Catch the exception that is unhandled in TryCast.
            Console.WriteLine
                ("Catching the {0} exception triggers the finally block.",
                ex.GetType());

            // Restore the original unhandled exception. You might not
            // know what exception to expect, or how to handle it, so pass 
            // it on.
            throw;
        }
    }

    public static void TryCast()
    {
        int i = 123;
        string s = "Some string";
        object obj = s;

        try
        {
            // Invalid conversion; obj contains a string, not a numeric type.
            i = (int)obj;

            // The following statement is not run.
            Console.WriteLine("WriteLine at the end of the try block.");
        }
        finally
        {
            // Report that the finally block is run, and show that the value of
            // i has not been changed.
            Console.WriteLine("\nIn the finally block in TryCast, i = {0}.\n", i);
        }
    }
    // Output:
    // In the finally block in TryCast, i = 123.

    // Catching the System.InvalidCastException exception triggers the finally block.

    // Unhandled Exception: System.InvalidCastException: Specified cast is not valid.
}

Weitere Informationen zu finally finden Sie unter try-catch-finally.For more information about finally, see try-catch-finally.

C# enthält auch die Using-Anweisung, die eine ähnliche Funktionalität für IDisposable-Objekte in einer zweckmäßigen Syntax bereitstellt.C# also contains the using statement, which provides similar functionality for IDisposable objects in a convenient syntax.

C#-ProgrammiersprachenspezifikationC# Language Specification

Weitere Informationen erhalten Sie unter C#-Sprachspezifikation. Die Sprachspezifikation ist die verbindliche Quelle für die Syntax und Verwendung von C#.

Siehe auchSee Also

C#-ReferenzC# Reference
C#-ProgrammierhandbuchC# Programming Guide
C#-SchlüsselwörterC# Keywords
try-, throw- und catch-Anweisungen (C++)try, throw, and catch Statements (C++)
AusnahmebehandlungsanweisungenException Handling Statements
throwthrow
try-catchtry-catch
Vorgehensweise: Explizites Auslösen von AusnahmenHow to: Explicitly Throw Exceptions