Partager via

Error, objet (ADO)

  • Article

S’applique à : Access 2013, Office 2013

Contient des détails sur les erreurs d'accès aux données relatives à une seule opération impliquant le fournisseur.

Remarques

Toute opération impliquant des objets ADO peut générer une ou plusieurs erreurs de fournisseur. Lorsqu'une erreur se produit, un ou plusieurs objets Error sont 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 ; le nouveau jeu d'objets Error est placé dans la collection Errors.

Remarque

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 On Error et apparaîtra dans l'objet Error. Pour obtenir la liste complète des erreurs ADO, voir la rubrique ErrorValueEnum.

Vous pouvez lire les propriétés d'un objet Error pour obtenir des détails spécifiques sur chaque erreur, notamment les suivantes :

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

  • la propriété Number, qui contient l'entier Long de la constante de l'erreur ;

  • La propriété Source, qui identifie l’objet qui a généré l’erreur. Cela est particulièrement utile lorsque vous avez plusieurs objets Error dans la collection Errors à la suite d’une demande adressée à une source de données.

  • les propriétés SQLState et NativeError, qui fournissent des informations depuis des sources de données SQL.

Lorsqu'une erreur liée au fournisseur se produit, elle est placée dans la collection Errors de l'objet Connection. ADO prend en charge le renvoi de plusieurs erreurs par une seule opération ADO pour la prise en charge des informations d'erreur spécifiques au fournisseur. Pour obtenir ce niveau élevé de détail dans un gestionnaire d'erreurs, utilisez les fonctions d'interception appropriées de la langue ou de l'environnement dans lesquels vous travaillez, puis utilisez des boucles imbriquées pour énumérer les propriétés de chaque objet Error dans la collection Errors.

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

Tout comme le font les fournisseurs, ADO efface l'objet OLE Error Info avant de lancer un appel susceptible de générer une nouvelle erreur spécifique du fournisseur. Toutefois, les objets présents dans la collection Errors sur l'objet Connection sont effacés et de nouveaux objets ne lui sont ajoutés que si le fournisseur génère une nouvelle erreur ou si la méthode Clear est appelée.

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.