Objeto de erro (ADO)

Aplica-se ao: Access 2013, Office 2013

Contém os detalhes sobre os erros de acesso aos dados que pertencem à uma única operação que envolve o 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 serão colocados na coleção Errors do objeto Connection. Quando a operação do ADO gerar um erro, a coleção Errors será limpa e o novo conjunto de objetos Error será colocado na coleção Errors.

Observação

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 de ADO disparará um evento On Error e aparecerá no objeto Error. Para obter uma lista completa dos erros do ADO, consulte o tópico ErrorValueEnum.

Leia as propriedades do objeto Error para obter os detalhes específicos sobre cada erro, incluindo o seguinte:

• A propriedade Description, que contém o texto do erro. Esta é a propriedade padrão.

• A propriedade Number, que contém o valor inteiro Long da constante de erro.

• A propriedade Source, que identifica o objeto que causou o erro. Isso será particularmente útil quando você tiver vários objetos Error na coleção Errors depois de uma solicitação de uma fonte de dados.

• As propriedades SQLState e NativeError que fornecem informações a partir das fontes de dados SQL.

Quando ocorrer um erro de provedor, este será colocado na coleção Errors do objeto Connection. O ADO suporta o retorno de vários erros ocasionados uma única operação do ADO para levar em conta as informações específicas do erro para o provedor. Para obter essas valiosas informações do erro em um manipulador de erros, use os recursos adequados para a interceptação de erros do idioma ou do ambiente no qual você estiver trabalhando e depois use os loops aninhados para enumerar as propriedades de cada objeto Error na coleção Errors.

Usuários do Microsoft Visual Basic e VBScriptSe não houver nenhum objeto Connection válido, você precisará recuperar informações de erro do objeto Error .

Exatamente como os provedores fazem, o ADO limpa o objeto OLE Error Info antes de fazer uma chamada que poderia gerar potencialmente um novo erro de provedor. No entanto, a coleção Errors no objeto Connection será limpa e preenchida somente quando o provedor gerar um novo erro ou quando o método Clear for chamado.

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, será possível ler a propriedade Count da coleção Errors para verificar os avisos retornados.