Freigeben über


throw (C#-Referenz)

Mit der throw-Anweisung wird das Auftreten einer außergewöhnlichen Situation oder Ausnahme während der Programmausführung signalisiert.

Hinweise

Die ausgelöste Ausnahme ist ein Objekt, dessen Klasse von Exception abgeleitet wird, wie im folgenden Beispiel gezeigt.

class MyException : System.Exception {}
// ...
throw new MyException();

Normalerweise wird die throw-Anweisung mit try-catch-Anweisungen oder try-finally-Anweisungen verwendet. Mit einer throw-Anweisung kann in einem catch-Block die Ausnahme erneut ausgelöst werden, die vom catch-Block abgefangen wurde. In diesem Fall verwendet die throw-Anweisung keinen Operanden für die Ausnahme. Weitere Informationen und Beispiele finden Sie unter try-catch (C#-Referenz) und Gewusst wie: Explizites Auslösen von Ausnahmen.

Beispiel

In diesem Beispiel wird veranschaulicht, wie mit der throw-Anweisung eine Ausnahme ausgelöst wird.

    public class ThrowTest2
    {

        static int GetNumber(int index)
        {
            int[] nums = { 300, 600, 900 };
            if (index > nums.Length)
            {
                throw new IndexOutOfRangeException();
            }
            return nums[index];

        }
        static void Main() 
        {
            int result = GetNumber(3);

        }
    }
    /*
        Output:
        The System.IndexOutOfRangeException exception occurs.
    */

Codebeispiel

Weitere Informationen finden Sie in den Beispielen in try-catch (C#-Referenz) und Gewusst wie: Explizites Auslösen von Ausnahmen.

C#-Programmiersprachenspezifikation

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

Siehe auch

Aufgaben

Gewusst wie: Explizites Auslösen von Ausnahmen

Referenz

try-catch (C#-Referenz)

Die try-, catch- und throw-Anweisung in C++

C#-Schlüsselwörter

Ausnahmebehandlungsanweisungen (C#-Referenz)

Konzepte

C#-Programmierhandbuch

Weitere Ressourcen

C#-Referenz