Instrução Error

Simula a ocorrência de um erro.

Sintaxe

Error errornumber  

Partes

errornumber
Obrigatórios. Pode ser qualquer número de erro inválido.

Comentários

A instrução Error possui suporte para compatibilidade com versões anteriores. No novo código, principalmente ao criar objetos, use o método Raise do objeto Err para gerar erros em tempo de execução.

Se errornumber estiver definido, a instrução Error chamará o manipulador de erros depois que as propriedades do objeto Err receberem os seguintes valores padrão:

Propriedade Valor
Number Valor especificado como argumento para instrução Error. Pode ser qualquer número de erro inválido.
Source Nome do projeto atual do Visual Basic.
Description Expressão de cadeia de caracteres correspondente ao valor retornado da função Error para a especificada Number, se essa cadeia de caracteres existir. Se a cadeia de caracteres não existir, Description conterá uma cadeia de caracteres de comprimento zero ("").
HelpFile A unidade totalmente qualificada, o caminho e o nome do arquivo de Ajuda do Visual Basic.
HelpContext A ID de contexto do arquivo de Ajuda do Visual Basic apropriada para o erro correspondente à propriedade Number.
LastDLLError Zero.

Se nenhum manipulador de erro existir ou estiver habilitado, uma mensagem de erro será criada e exibida a partir das propriedades do objeto Err.

Observação

Alguns aplicativos host do Visual Basic não podem criar objetos. Consulte a documentação do aplicativo host para determinar se ele pode criar classes e objetos.

Exemplo

Este exemplo usa a instrução Error para gerar o erro número 11.

On Error Resume Next   ' Defer error handling.  
Error 11   ' Simulate the "Division by zero" error.  

Requisitos

Namespace: Microsoft.VisualBasic

Assembly: Biblioteca de Tempo de Execução do Visual Basic (em Microsoft.VisualBasic.dll)

Confira também