Instrução Error
Simula a ocorrência de um erro.
Sintaxe
Númerode erro
O número de erro necessário pode ser qualquer número de erro válido.
Comentários
A instrução Error é suportada para retrocompatibilidade. No novo código, especialmente ao criar objetos, utilize o método Raise do objeto Err para gerar erros de tempo de execução.
Se a numeração de erro estiver definida, a instrução Erro chama o processador de erros depois de as propriedades do objeto Err serem atribuídas aos seguintes valores predefinidos:
| 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 correspondente ao valor devolvido da função Error para o Número especificado, se esta cadeia existir. Se a cadeia não existir, Descrição contém uma cadeia de comprimento zero (""). |
| HelpFile | A unidade, o caminho e o nome de ficheiro completamente qualificados do ficheiro de Ajuda do Visual Basic adequado. |
| HelpContext | O ID de contexto do ficheiro da Ajuda do Visual Basic adequado para o erro correspondente à propriedade Número . |
| LastDLLError | Zero. |
Se não existir nenhum processador de erros ou se nenhum estiver ativado, será criada e apresentada uma mensagem de erro a partir das propriedades do objeto Err .
Observação
Nem todas as aplicações anfitriãs do Visual Basic podem criar objetos; por exemplo, os anfitriões com versões de Visual Basic for Applications anteriores à 4.0 não podem criar objetos. Uma vez que Err é uma função que devolve uma instância ErrObject , não pode ser utilizada nestas versões anteriores. Para saber qual é a versão do VBA que a sua aplicação anfitriã está a executar, veja As informações sobre o visual basic Editor (VBE) e veja a documentação da aplicação anfitriã para determinar se pode criar classes e objetos.
Exemplo
Este exemplo utiliza a instrução Erro 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.