Partager via

Error, objet

  • Article

Contient des détails sur les erreurs d’accès aux données qui se rapportent à une seule opération impliquant le fournisseur.

Notes

Toute opération impliquant des objets ADO peut générer une ou plusieurs erreurs de fournisseur. À mesure que chaque erreur se produit, un ou plusieurs objets Error sont placés dans la collection Errors de l’objet Connection. Quand une autre opération ADO génère une erreur, la collection Errors est effacée et le nouvel ensemble d’objets Error est placé dans la collection Errors.

Notes

Chaque objet Error représente une erreur de fournisseur spécifique, et non une erreur ADO. Les erreurs ADO sont exposées au mécanisme de gestion des exceptions à l’exécution. Par exemple, dans Microsoft Visual Basic, l’occurrence d’une erreur spécifique à ADO déclenche un événement On Error et s’affiche dans l’objet Error. Pour obtenir la liste complète des erreurs ADO, consultez la rubrique ErrorValueEnum.

Vous pouvez lire les propriétés d’un objet Error pour obtenir des détails spécifiques sur chaque erreur, y compris les éléments suivants :

  • Propriété Description, qui contient le texte de l’erreur. Il s’agit de la propriété par défaut.

  • Propriété Number, qui contient la valeur entière Long de la constante d’erreur.

  • Propriété Source, qui identifie l’objet qui a déclenché l’erreur. Cela est particulièrement utile lorsque vous avez plusieurs objets Error dans la collection Errors après une requête auprès d’une source de données.

  • Propriétés SQLState et NativeError, qui fournissent des informations à partir de sources de données SQL.

Lorsqu’une erreur de fournisseur se produit, elle est placée dans la collection Errors de l’objet Connection. ADO prend en charge le retour de plusieurs erreurs par une seule opération ADO pour autoriser les informations d’erreur spécifiques au fournisseur. Pour obtenir ces informations d’erreur enrichies dans un gestionnaire d’erreurs, utilisez les fonctionnalités appropriées de capture d’erreur du langage ou de l’environnement avec lequel vous travaillez, puis utilisez des boucles imbriquées pour énumérer les propriétés de chaque objet Error dans la collection Errors.

Notes

Utilisateurs Microsoft Visual Basic et VBScript S’il n’existe aucun objet Connection valide, vous devez récupérer les informations d’erreur de l’objet Error.

Tout comme les fournisseurs, ADO efface l’objet OLE Error Info avant d’effectuer un appel susceptible de générer une nouvelle erreur de fournisseur. Toutefois, la collection Errors sur l’objet Connection est effacée et renseignée uniquement lorsque le fournisseur génère une nouvelle erreur ou lorsque la méthode Clear est appelée.

Certaines propriétés et méthodes retournent des avertissements qui apparaissent sous forme d’objets Error dans la collection Errors, mais n’arrêtent pas l’exécution d’un programme. Avant d’appeler les méthodes Resync, UpdateBatch ou CancelBatch sur un objet Recordset, la méthode Open sur un objet Connection ou de définir la propriété Filter sur un objet Recordset, appelez la méthode Clear sur la collection Errors. De cette façon, vous pouvez lire la propriété Count de la collection Errors pour tester les avertissements retournés.

L’objet Error n’est pas sécurisé pour les scripts.

Cette section contient la rubrique suivante.

Voir aussi

Exemple des propriétés Description, HelpContext, HelpFile, NativeError, Number, Source, et SQLState (VB)
Exemple des propriétés Description, HelpContext, HelpFile, NativeError, Number, Source, et SQLState (VC++)
Connection, objet (ADO)
Errors, collection (ADO)
Annexe A : Fournisseurs