Coleção Errors (ADO)

Contém todos os objetos Error criados em resposta a uma única falha relacionada ao provedor.

Comentários

Qualquer operação envolvendo objetos ADO pode gerar um ou mais erros de provedor. À medida que cada erro ocorre, um ou mais objetos Error podem ser colocados na coleção Errors do objeto Connection. Quando outra operação 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ção 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 efeito na coleção Errors. Use o método Clear para limpar manualmente a coleção Errors.

O conjunto de objetos Error na coleção Errors descreve todos os erros ocorridos em resposta a uma única instrução. Enumerar os erros específicos na coleção Errors 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 recuperação.

Algumas propriedades e métodos retornam avisos que aparecem como objetos Error na coleção Errors, 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 de definir a propriedade Filter em um objeto Recordset, chame o método Clear na coleção Errors. Dessa forma, você pode ler a propriedade Count da coleção Errors para testar os avisos retornados.

Observação

Confira o tópico do objeto Error para obter uma explicação mais detalhada da maneira como uma única operação ADO pode gerar vários erros.

Esta seção contém o tópico a seguir.

• Propriedades, métodos e eventos da coleção Errors

Consulte Também

Objeto Error
Apêndice A: Provedores