Objet Error |
Dim error As ADODB.Error L'objet Error contient des informations concernant une erreur ou un avertissement spécifiques générés par un fournisseur de données pendant une opération ADO.

Propriété Error.Description | (Versions 2.0, 2.1, 2.5 et 2.6)
description = error.Description
La propriété Description décrit l'erreur ou l'avertissement générés par l'objet ADO ou par le fournisseur de données.
Type de données
Chaîne
Description
La propriété Description de l'objet Error est en lecture seule. Elle présente les informations d'erreur ou d'avertissement sous forme de chaîne permettant d'avertir l'utilisateur de votre application des erreurs ou avertissements qui surviennent. La valeur de la propriété Description est générée par l'objet ADO ou par le fournisseur.

Propriété Error.HelpContext Property/Error.HelpFile | (Versions 2.0, 2.1, 2.5 et 2.6)
helpcontext = error.HelpContext helpfile = error.HelpFile
Les propriétés HelpContext et HelpFile indiquent respectivement la rubrique et le nom d'une erreur spécifique à l'intérieur d'un objet Error.
Type de données
Long (propriété HelpContext) Chaîne (propriété HelpFile)
Description
La propriété HelpFile contient un chemin d'accès complet à un fichier Aide de Windows. La propriété HelpContext affiche automatiquement une rubrique d'aide du fichier Aide de Windows, qui est indiquée par la propriété HelpFile. Si aucune rubrique d'aide n'est pertinente à l'erreur générée, la propriété HelpContext renvoie zéro et la propriété HelpFile renvoie une chaîne vide (").

Propriété Error.NativeError | (Versions 2.0, 2.1, 2.5 et 2.6)
nativeerror = error.NativeError
La propriété NativeError renvoie le code d'erreur livré par le fournisseur de données pour l'objet Error en cours.
Type de données
Long
Description
Utilisez cette propriété pour extraire les codes d'erreur qui sont transmis de la source de données au fournisseur de données, puis à l'objet ADO.

Propriété Error.Number | (Versions 2.0, 2.1, 2.5 et 2.6)
number = error.Number
La propriété Number est utilisée uniquement pour identifier l'erreur spécifiée par l'objet Error en cours.
Type de données
Long ou ErrorValueEnum (Long)
Description
La valeur de la propriété Number est un numéro unique décrivant une erreur qui s'est produite. Il peut s'agir d'une valeur d'énumération ErrorValueEnum indiquée dans le tableau E-18.
Voir aussi
Enumération ErrorValueEnum

Propriété Error.Source | (Versions 2.0, 2.1, 2.5 et 2.6)
source = error.Source
La propriété Source renvoie le nom d'un objet ou d'une application ayant généré une erreur à l'intérieur de l'objet ADO.
Type de données
L'objet Error renvoie une chaîne.
Description
Pour les objets Error, la propriété Source indique le nom de l'objet ou de l'application ayant généré à l'origine une erreur à l'intérieur de l'objet ADO. Les erreurs ADO indiquent une valeur de source commençant par la valeur ADODB., suivie du nom de l'objet ayant généré l'erreur.

Propriété Error.SQLState | (Versions 2.0, 2.1, 2.5 et 2.6)
sqlstate = error.SQLState
La propriété SQLState renvoie l'état SQL de l'objet Error en cours.
Type de données
Chaîne (cinq caractères)
Description
Utilisez cette propriété pour extraire le code d'erreur de cinq caractères renvoyé par le fournisseur de données à l'objet ADO lorsqu'une erreur survient pendant le traitement d'une instruction SQL. Ces codes d'erreur sont généralement au format ANSI SQL standard, mais peuvent être différents selon le fournisseur de données.

Collection Errors | (Versions 2.0, 2.1, 2.5 et 2.6)
Set errors = connection.Errors
Voir la section Objet Error pour plus d'informations et des exemples en rapport avec la collection Errors.
Objets
Error Contient des informations concernant une erreur ou un avertissement spécifiques générés par l'objet ADO pendant une opération.
Méthodes
Clear La méthode Clear efface toutes les erreurs stockées dans la collection Errors. Refresh La méthode Refresh de la collection Errors est une méthode non documentée de l'objet ADO, présente depuis la version 2.0.
Propriétés
Count Indique le nombre d'objets Error appartenant à la collection Errors associée. Item Permet d'accéder à un objet Error spécifique appartenant à la collection Errors.

Méthode Errors.Clear | (Versions 2.0, 2.1, 2.5 et 2.6)
errors.Clear
La méthode Clear efface toutes les erreurs stockées dans la collection Errors.
Description
La méthode Clear efface la collection en cours d'erreurs ADO. Lorsqu'une nouvelle erreur d'exécution est générée, la collection Errors est automatiquement effacée, puis complétée avec les informations sur l'erreur. Utilisez cette méthode lorsque vous prévoyez d'effectuer des appels vers un objet Recordset pouvant renvoyer plusieurs avertissements. Ces appels incluent Delete, Resync, UpdateBatch et CancelBatch. Une fois l'un de ces appels effectués, après avoir effacé la collection Errors, vous pouvez constater si des avertissements ont été générés par l'appel en question.
Voir aussi
Méthode Recordset.CancelBatch, Méthode Recordset.Delete, Méthode Recordset.Resync, Méthode Recordset.UpdateBatch

Propriété Errors.Count | (Versions 2.0, 2.1, 2.5 et 2.6)
count = errors.Count
La propriété Count indique le nombre d'objets Error appartenant à la collection Errors associée.
Type de données
Long
Description
Si la valeur de la propriété Count indique zéro, il n'existe aucun objet Error dans la collection Errors associée. Toutefois, les objets Error appartenant à la collection Errors associée sont indexés de 0 à la valeur de la propriété Count moins un.

Propriété Errors.Item | (Versions 2.0, 2.1, 2.5 et 2.6)
Set error = errors.Item(Index) Set error = errors (Index)
La propriété Item permet d'accéder à un objet Error spécifique appartenant à la collection Errors.
Type de données
Objet Error
Description
L'espace réservé Index représente un type de données Variant; équivalent à la position ordinale d'un objet Error dans la collection Errors. Si la collection Errors ne contient pas l'élément requis, une erreur est générée.
Remarque
Certains langages ne prennent pas en charge la propriété Item dans la première syntaxe. Le cas échéant, utilisez la seconde syntaxe, sans le nom de méthode Item.

Méthode Errors.Refresh | (Versions 2.0, 2.1, 2.5 et 2.6)
errors.Refresh
La méthode Refresh de la collection Errors est une méthode non documentée de l'objet ADO, présente depuis la version 2.0.
Description
La méthode Errors.Refresh permet de rechercher de nouveau des erreurs dans l'objet ADO.