Instrução Throw (Visual Basic)

Gera uma exceção dentro de um procedimento.

Sintaxe

Throw [ expression ]

Parte

expression
Fornece informações sobre a exceção a ser gerada. Opcional ao residir em uma Catch instrução, caso contrário, necessário.

Observações

A Throw instrução gera uma exceção que você pode manipular com código estruturado de tratamento de exceções (Try...Catch...Finally) ou código de tratamento de exceção não estruturado (On Error GoTo). Você pode usar a Throw instrução para interceptar erros em seu código porque o Visual Basic move a pilha de chamadas até encontrar o código apropriado de tratamento de exceções.

Uma Throw instrução sem expressão só pode ser usada em uma Catch instrução, nesse caso, a instrução reaplica a exceção que está sendo tratada pela Catch instrução.

A Throw instrução redefine a pilha de chamadas para a expression exceção. Se expression não for fornecido, a pilha de chamadas ficará inalterada. Você pode acessar a pilha de chamadas para a exceção por meio da StackTrace propriedade.

Exemplo

O código a seguir usa a Throw instrução para gerar uma exceção:

' Throws a new exception.
Throw New InvalidOperationException("The operation is not valid for the current state.")

Consulte também

• Instrução Try...Catch...Finally
• Instrução On Error