Coleção Errors (ADO)
Contém todos os objetos Error criados em resposta a uma única falha relacionada ao provedor.
Observações
Qualquer operação que envolva objetos ADO pode gerar um ou mais erros de provedor. À medida que cada erro ocorre, um ou mais objetos Erro podem ser colocados na coleção Erros do objeto conexão. Quando outra operação do ADO gera um erro, a coleção Errors é desmarcada e o novo conjunto de objetos Error pode ser colocado na coleção Errors.
Cada objeto Error representa um erro específico do provedor, não um erro do ADO. Os erros do ADO são expostos ao mecanismo de tratamento de exceções em tempo de execução. Por exemplo, no Microsoft Visual Basic, a ocorrência de um erro específico do ADO disparará um evento onError e aparecerá no objeto Err.
As operações do ADO que não geram um erro não têm nenhum efeito na coleção erros de. Use o método Clear para limpar manualmente a coleção erros de.
O conjunto de objetos Error na coleção Errors descreve todos os erros que ocorreram em resposta a uma única instrução. Enumerar os erros específicos na coleção Erros permite que suas rotinas de tratamento de erros determinem com mais precisão a causa e a origem de um erro e executem as etapas apropriadas para recuperar.
Algumas propriedades e métodos retornam avisos que aparecem como objetos Error na coleção erros de, mas não interrompem a execução de um programa. Antes de chamar os métodos Resync, UpdateBatch ou CancelBatch em um objeto Recordset, o método Open em um objeto Connection ou defina a propriedade filtro em um objeto Recordset, chame o método Clear na coleção Errors. Dessa forma, você pode ler a propriedade Count da coleção Erros para testar os avisos retornados.
Nota
Consulte o tópico do objeto Error para obter uma explicação mais detalhada sobre como uma única operação do ADO pode gerar vários erros.
Esta seção contém o tópico a seguir.
Consulte Também
do objeto de erro
apêndice A : provedores