Objeto Error
Contém detalhes sobre erros de acesso a dados que pertencem a uma única operação envolvendo o 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 Error são colocados na coleção Erros do objeto connection. Quando outra operação do ADO gera um erro, a coleção Errors é desmarcada e o novo conjunto de objetos Error é colocado na coleção Errors.
Nota
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 On Error e aparecerá no objeto Error. Para obter uma lista completa de erros do ADO, consulte o tópico ErrorValueEnum.
Você pode ler as propriedades de um Error objeto 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 para o provedor. Para obter essas informações de erro avançadas em um manipulador de erros, use os recursos apropriados de interceptação de erros do idioma ou ambiente com o qual você está trabalhando e use loops aninhados para enumerar as propriedades de cada objeto Error na coleção Errors.
Nota
Microsoft Visual Basic e VBScript Users Se não houver nenhum objeto de Conexão válido, você precisará recuperar informações de erro do objeto Error.
Assim como os provedores fazem, o ADO limpa o objeto informações de erro OLE antes de fazer uma chamada que poderia potencialmente gerar um novo erro do provedor. No entanto, a coleção erros de no objeto conexão é desmarcada 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 erros de, mas não interrompem a execução de um programa. Antes de chamar os métodos Resync, UpdateBatchou CancelBatch em um objeto Recordset; o método Open em um objeto de Conexão; ou defina a propriedade Filter em um objeto Recordset, chame o método Clear na coleção Erros. Dessa forma, você pode ler a propriedade Count da coleção erros de 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
Description, HelpContext, HelpFile, NativeError, Number, Source e SQLState Properties Example (VB)
Descrição, HelpContext, HelpFile, NativeError, Number, Source e SQLState Properties Example (VC++)
do objeto de conexão (ADO)
coleção de erros (ADO)
apêndice A : provedores