throw (Referência de C#)
A instrução throw é usada para sinalizar a ocorrência de uma situação anômala (exceção) durante a execução do programa.
Comentários
A exceção acionada é um objeto cuja classe é derivada de Exception conforme mostrado no exemplo a seguir.
class MyException : System.Exception {}
// ...
throw new MyException();
Geralmente, a instrução throw é usada com try-catch ou instruções try-finally. Uma instrução throw pode ser usada em um bloco catch para acionar novamente a exceção que o bloco catch identificou. Nesse caso, a instrução throw não usa um operando de exceção. Para obter mais informações e exemplos, consulte try-catch (Referência de C#) e Como lançar exceções explicitamente.
Exemplo
Este exemplo demonstra como acionar uma exceção usando a instrução throw.
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.
*/
Exemplo de código
Consulte os exemplos em try-catch (Referência de C#) e Como lançar exceções explicitamente.
Especificação da Linguagem C#
Para obter mais informações, consulte a Especificação da linguagem C#. A especificação da linguagem é a fonte definitiva para a sintaxe e o uso de C#.
Consulte também
Tarefas
Como lançar exceções explicitamente
Referência
As instruções try, catch e throw em C++
Instruções para manipulação de exceções (Referência de C#)