Errors, collection (ADO)

S’applique à : Access 2013, Office 2013

Contient tous les objets Error créés en réponse à une erreur liée au fournisseur.

Remarques

Toute opération impliquant des objets ADO peut générer une ou plusieurs erreurs d'un fournisseur. Lorsqu'une erreur se produit, un ou plusieurs objets Error peuvent être placés dans la collection Errors de l'objet Connection. Lorsqu'une autre opération ADO génère une erreur, la collection Errors est vidée de son contenu, et le nouveau jeu d'objets Error peut être placé dans la collection Errors.

Chaque objet Error représente une erreur de fournisseur spécifique, et pas une erreur ADO. Les erreurs ADO sont exposées au mécanisme de gestion des exceptions d'exécution. Par exemple, dans Microsoft Visual Basic, l'occurrence d'une erreur ADO spécifique déclenchera un événement onError et apparaîtra dans l'objet Err.

Les opérations ADO qui ne génèrent pas d'erreur sont sans effet sur la collection Errors. Utilisez la méthode Clear pour effacer manuellement le contenu de la collection Errors.

Le jeu d'objets Error de la collection Errors décrit toutes les erreurs qui ont eu lieu en réponse à une seule instruction. Le fait d'énumérer les erreurs spécifiques dans la collection Errors permet à vos routines de gestion des erreurs de déterminer avec plus de précision la cause et l'origine d'une erreur et d'exécuter les actions appropriées pour la corriger.

Certaines propriétés et méthodes renvoient des avertissements qui s'affichent sous la forme d'objets Error dans la collection Errors, mais qui n'empêchent 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 avant de définir la propriété Filter sur un objet Recordset, appelez la méthode Clear sur la collection Errors. Ceci vous permet de lire la propriété Count de la collection Errors pour tester les avertissements renvoyés.