Coleção de erros (ADO)

Aplica-se ao: Access 2013, Office 2013

Contém todos os objetos Error criados em resposta à falha relacionada a um único provedor.

Comentários

Qualquer operação envolvendo os objetos ADO pode gerar um ou vários erros de provedor. À medida que cada erro ocorrer, um ou vários objetos Error poderão ser colocados na coleção Errors do objeto Connection. Quando outra operação do ADO gerar um erro, a coleção Errors será limpa e o novo conjunto de objetos Error poderá ser colocado na coleção Errors.

Cada objeto Error representa um erro de provedor específico e não um erro do ADO. Os erros do ADO são apresentados no mecanismo de tratamento de exceções do 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 sobre a 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 que ocorreram em resposta a uma única instrução. A enumeração dos erros específicos na coleção Errors permite rotinas de tratamento de erros para determinar de modo mais preciso a causa e a origem de um erro e executar 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 suspendem 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 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 verificar os avisos retornados.