Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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. À 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 .
Remarque
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 au moment de 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 apparaît 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 adressée à 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 permettre des 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 d’interruption 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 .
Remarque
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 remplie 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 s’affichent sous la 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 ; méthode Open sur un objet Connection ; ou définissez 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 le script.
Cette section contient la rubrique suivante.
Voir aussi
Description, HelpContext, HelpFile, NativeError, Number, Source et SQLState Properties Example (VB)
Description, HelpContext, HelpFile, NativeError, Number, Source et SQLState Properties Example (VC++)
Objet de Connexion (ADO)
Errors, collection (ADO)
Annexe A : Fournisseurs