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.