Instrução Error

  • Artigo

Simula a ocorrência de um erro.

Sintaxe

Númerode erros

O número de erros necessário pode ser qualquer número de erro válido.

Comentários

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

Se o número de erros for 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
Número Valor especificado como argumento para a instrução Error . Pode ser qualquer número de erro válido.
Fonte Nome do projeto atual do Visual Basic.
Descrição Expressão de cadeia de caracteres correspondente ao valor retornado da função Error para o número especificado, se essa cadeia de caracteres existir. Se a cadeia de caracteres não existir, a Descrição conterá uma cadeia de caracteres de comprimento zero ("").
HelpFile A unidade, o caminho e o nome do arquivo totalmente qualificados do arquivo de ajuda do Visual Basic apropriado.
HelpContext A ID de contexto de arquivo do Visual Basic Help apropriada para o erro correspondente à propriedade Number .
LastDLLError Zero.

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

Observação

Nem todos os aplicativos host do Visual Basic podem criar objetos; por exemplo, os hosts que executam versões de Visual Basic for Applications anteriores a 4.0 não podem criar objetos. Como err é uma função que retorna uma instância ErrObject , ela não pode ser usada nessas versões iniciais. Para saber qual versão do VBA seu aplicativo host está em execução, consulte as informações sobre para seu VBE (Editor do Visual Basic) e 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 simular o erro número 11.

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

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.