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 System.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. Weitere Informationen und Beispiele finden Sie unter try-catch (C#-Referenz) und Gewusst wie: Explizites Auslösen von Ausnahmen.
Beispiel
In diesem Beispiel wird demonstriert, wie mit der throw-Anweisung eine Ausnahme ausgelöst werden kann.
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 finden Sie in der 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
Die try-, catch- und throw-Anweisung in C++
Ausnahmebehandlungsanweisungen (C#-Referenz)