Partilhar via


Objeto Error

Contém detalhes sobre erros de acesso a dados que pertencem a uma única operação envolvendo o 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 são 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 é colocado na coleção Errors.

Observação

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

Você pode ler as propriedades de um objeto Error para obter detalhes específicos sobre cada erro, incluindo o seguinte:

  • A propriedade Description, que contém o texto do erro. Essa é 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 gerou o erro. Isso é particularmente útil quando você tem vários objetos Error na coleção Errors após uma solicitação a uma fonte de dados.

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

Quando ocorre um erro de provedor, ele é colocado na coleção Errors do objeto Connection. O ADO dá suporte ao retorno de vários erros por uma única operação do ADO para permitir informações de erro específicas do provedor. Para obter essas informações de erro avançadas em um manipulador de erros, use os recursos apropriados de captura de erro da linguagem ou do ambiente com o qual você está trabalhando e use loops aninhados para enumerar as propriedades de cada objeto Error na coleção Errors.

Observação

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

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

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.

O objeto Error não é seguro para scripts.

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

Consulte Também

Exemplo das propriedades Description, HelpContext, HelpFile, NativeError, Number, Source e SQLState (VB)
Exemplo das propriedades Description, HelpContext, HelpFile, NativeError, Number, Source e SQLState (VC++)
Objeto Connection (ADO)
Coleção Errors (ADO)
Apêndice A: Provedores