Errors, collection (ADO)

  • Article

Contient tous les objets Error créés en réponse à un échec lié à un fournisseur unique.

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 peuvent être 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 peut être placé dans la collection Errors.

Chaque objet Error représente une erreur de fournisseur spécifique, 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 d’ADO déclenche un événement onError et s’affiche dans l’objet Err.

Les opérations ADO qui ne génèrent pas d’erreur n’ont aucune incidence sur la collection Errors. Utilisez la méthode Clear pour effacer manuellement la collection Errors.

L’ensemble d’objets Error dans la collection Errors décrit toutes les erreurs qui se sont produites en réponse à une instruction. L’énumération des erreurs spécifiques dans la collection Errors permet à vos routines de gestion des erreurs de déterminer plus précisément la cause et l’origine d’une erreur, ainsi que de prendre des mesures appropriées pour récupérer.

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.

Notes

Pour une explication plus détaillée de la façon dont une simple opération ADO peut générer plusieurs erreurs, consultez la rubrique de l’objet Error.

Cette section contient la rubrique suivante.

Voir aussi

Error, objet
Annexe A : Fournisseurs