Package | flash.errors |
Classe | public class SQLError |
Héritage | SQLError Error Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
En mode d’exécution asynchrone, lorsqu’une erreur survient dans une opération de bases de données SQL, l’occurrence SQLConnection ou SQLStatement distribue un objet SQLErrorEvent. Vous pouvez accéder aux informations sur l’erreur sous forme d’occurrence SQLError depuis la propriété error
de l’objet SQLErrorEvent.
En mode d’exécution asynchrone, si une erreur se produit lors d’une opération de la base de données SQL, l’occurrence SQLConnection ou SQLStatement émet une exception SQLError ; celle-ci peut être traitée en insérant le code d’erreur dans un bloc try..catch
.
Cette classe fournit des propriétés contenant les informations sur l’erreur (notamment la définition du type d’erreur survenue), un message de texte décrivant l’erreur, ainsi que l’opération ayant provoqué l’erreur.
Plus d’exemples
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
detailArguments : Array [lecture seule]
Tableau de valeurs de String pouvant être utilisé pour construire un message d’erreur détaillé spécifique local. | SQLError | ||
detailID : int [lecture seule]
Numéro de référence associé au message détaillé spécifique. | SQLError | ||
details : String [lecture seule]
Informations sur l’erreur actuelle. | SQLError | ||
errorID : int [lecture seule]
Contient le numéro de référence associé au message d’erreur spécifique. | Error | ||
message : String
Contient le message associé à l’objet Error. | Error | ||
name : String
Contient le nom de l’objet Error. | Error | ||
operation : String [lecture seule]
Valeur indiquant l’opération en cours lorsque l’erreur est survenue. | SQLError |
Méthode | Défini par | ||
---|---|---|---|
SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)
Crée une occurrence SQLError pouvant être renvoyée ou utilisée avec la propriété error d’une occurrence SQLErrorEvent. | SQLError | ||
Renvoie la pile d’appel pour générer une erreur au moment de la construction de l’erreur en tant que chaîne. | Error | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la chaîne « Error » par défaut ou la valeur contenue dans la propriété Error.message, si elle est définie. | SQLError | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
detailArguments | propriété |
detailArguments:Array
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.1 |
Tableau de valeurs de String pouvant être utilisé pour construire un message d’erreur détaillé spécifique local.
Cette propriété contient la ou les valeurs substituées dans le message d’erreur de la propriété details
pour désigner le ou les objets de base de données spécifiques (nom de la table, nom de la colonne, etc.) associés à l’erreur. Par exemple, supposons qu’une erreur se produise dans une application avec le message d’erreur de propriété details
suivant :
there is already another table or index with this name: 'my_table'
Dans ce cas, la propriété detailArguments
de l’occurrence SQLError contiendrait un seul élément avec la valeur "my_table"
.
Grâce à la propriété detailID
, l’application peut identifier le message d’erreur details
spécifique. L’application peut alors fournir un autre texte à l’utilisateur, dans sa langue. Les valeurs des arguments du tableau detailArguments
peuvent être substituées à la position appropriée dans la chaîne du message d’erreur. Cela est très utile pour les applications qui souhaitent afficher le message d’erreur de la propriété details
de cette erreur directement aux utilisateurs finaux dans une langue spécifique.
Pour obtenir la liste des valeurs detailID
et des messages d’erreur et arguments correspondants (en anglais), voir « ID, arguments et messages d’erreur SQL détaillés ».
Implémentation
public function get detailArguments():Array
detailID | propriété |
detailID:int
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.1 |
Numéro de référence associé au message détaillé spécifique. Cette valeur est utilisée pour prendre en charge les traductions spécifiques locales du message d’erreur de la propriété details
.
Cette propriété fournit un identifiant unique pour chaque message details
(pour tout type d’erreur avec errorID
spécifique, il existe plusieurs erreurs avec des valeurs detailID
uniques). L’utilisation de cet identifiant avec la ou les valeurs du tableau detailArguments
permet à une application de fournir des messages d’erreur détaillés spécifiques locaux. Cela est très utile pour les applications qui souhaitent afficher le message d’erreur de la propriété details
de cette erreur directement aux utilisateurs finaux dans une langue spécifique.
Pour obtenir la liste des valeurs detailID
et des messages d’erreur et arguments correspondants (en anglais), voir « ID, arguments et messages d’erreur SQL détaillés ».
Implémentation
public function get detailID():int
details | propriété |
operation | propriété |
operation:String
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
Valeur indiquant l’opération en cours lorsque l’erreur est survenue. Cette valeur correspond à l’une des occurrences définies dans la classe SQLErrorOperation.
Implémentation
public function get operation():String
Eléments de l’API associés
SQLError | () | Constructeur |
public function SQLError(operation:String, details:String = "", message:String = "", id:int = 0, detailID:int = -1, detailArgs:Array = null)
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
Crée une occurrence SQLError pouvant être renvoyée ou utilisée avec la propriété error
d’une occurrence SQLErrorEvent.
operation:String — Indique l’opération spécifique ayant provoqué l’échec. Valeur de l’une des occurrences définies dans la classe SQLErrorOperation.
| |
details:String (default = " ") — Informations sur l’erreur actuelle.
| |
message:String (default = " ") — Description de l’erreur qui s’est produite.
| |
id:int (default = 0 ) — Numéro de référence associé au message d’erreur spécifique.
| |
detailID:int (default = -1 ) — Numéro de référence associé au message d’erreur détaillé.
| |
detailArgs:Array (default = null ) — Tableau ordonné des valeurs de substitution pouvant être utilisées pour construire un message d’erreur détaillé propre aux paramètres régionaux.
|
Eléments de l’API associés
toString | () | méthode |
Tue Jun 12 2018, 09:30 AM Z