Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Simula a ocorrência de um erro.
Sintaxe
Errorerrornumber
O número de erro necessário pode ser qualquer número de erro válido.
Comentários
A instrução Error tem suporte para compatibilidade com versões anteriores. Em um novo código, especialmente ao criar objetos, use o método Raise do objeto Err para gerar erros em tempo de execução.
Se errornumber 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 comprimento zero (""). |
| HelpFile | A unidade totalmente qualificada, o caminho e o nome do arquivo de Ajuda do Visual Basic apropriado. |
| 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 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, hosts que executam versões do Visual Basic for Applications anteriores à 4.0 não podem criar objetos. Como Err é uma função que retorna uma instância de ErrObject , ela não pode ser usada nessas versões anteriores. Para saber qual versão do VBA seu aplicativo host está executando, consulte as informações Sobre do seu Editor do Visual Basic (VBE) 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.