Objet 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 | |
|
|
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 | |
|
|
Méthodes | |
|
|
Propriétés | |
|
|
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. |
|