| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
La classe Error contient des informations sur une erreur survenue dans un script. Lorsque vous développez des applications ActionScript 3.0, une boîte de dialogue indique les exceptions de type Error ou associées à une sous-classe si vous exécutez le code compilé dans la version de débogage de Flash Player, pour vous aider à corriger le code. Vous pouvez créer un objet Error à l'aide de la fonction constructeur
Error. En général, vous générez un nouvel objet Error à partir d'un bloc de code
try, qui est ensuite détecté par un bloc de code
catch ou
finally.
Vous pouvez également créer une sous-classe de la classe Error et générer des occurrences de cette sous-classe.
Consulter les exemples
errorID:int [lecture seule]
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Contient le numéro de référence associé au message d'erreur spécifique. Pour un objet Error personnalisé, ce nombre correspond à la valeur du paramètre id fourni dans le constructeur.
Implémentation public function get errorID():intpublic var message:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Contient le message associé à l'objet Error. Par défaut, la valeur de cette propriété est « Error ». Vous pouvez spécifier une propriété message lorsque vous créez un objet Error en transmettant la chaîne d'erreur à la fonction constructeur Error.
Voir aussi
public var name:String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Contient le nom de l'objet Error. Par défaut, la valeur de cette propriété est « Error ».
Voir aussi
public function Error(message:String = "", id:int = 0)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Crée un nouvel objet Error. Si message est spécifié, sa valeur est affectée à la propriété Error.message de l'objet.
Paramètres | message:String (default = "") — Chaîne associée à l'objet Error. Ce paramètre est facultatif. |
| |
| id:int (default = 0) — Numéro de référence à associer au message d'erreur spécifique. |
Voir aussi
Exemple
L'exemple suivant crée un nouvel objet Error,
err puis, à l'aide du constructeur
Error(), affecte la chaîne
"New Error Message" à
err.
var err:Error = new Error();
trace(err.toString()); // Error
err = new Error("New Error Message");
trace(err.toString()); // Error: New Error Message
public function getStackTrace():String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Renvoie la pile d'appels d'une erreur sous la forme d'une chaîne lors de la construction de l'erreur (version de débogage de Flash Player et application de débogage du lanceur AIR seulement) ; renvoie la valeur null lorsque ni la version de débogage de Flash Player ni l'application de débogage du lanceur AIR n'est utilisée. Comme indiqué dans l'exemple suivant, la première ligne de la valeur renvoyée est une chaîne qui représente l'objet d'exception, suivi par les éléments de la pile de suivi :
TypeError: null cannot be converted to an object
at com.xyz.OrderEntry.retrieveData(OrderEntry.as:995)
at com.xyz.OrderEntry.init(OrderEntry.as:200)
at com.xyz.OrderEntry.$construct(OrderEntry.as:148)
Valeur renvoyée | String — Représentation sous forme de chaîne de la pile d'appels. |
override public function toString():String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Renvoie la chaîne "Error" par défaut ou la valeur contenue dans la propriété Error.message, si elle est définie.
Valeur renvoyéeVoir aussi
Exemple
L'exemple suivant crée un nouvel objet Error,
err puis, à l'aide du constructeur
Error(), affecte la chaîne
"New Error Message" à
err. Enfin, la propriété
message est définie sur
"Another New Error Message", qui remplace
"New Error Message".
var err:Error = new Error();
trace(err.toString()); // Error
err = new Error("New Error Message");
trace(err.toString()); // Error: New Error Message
err.message = "Another New Error Message";
trace(err.toString()); // Error: Another New Error Message
L'exemple suivant exploite la classe
ErrorExample pour indiquer comment générer une erreur personnalisée. Cette opération s'accomplit de la façon suivante :
-
Une variable locale,
nullArray, de type Array est déclaré. Vous remarquerez qu'aucun objet Array n'est créé.
-
Le constructeur tente de charger une valeur dans le tableau non initialisé en utilisant la méthode
push() au sein d 'un segment de code de traitement des erreurs qui intercepte une erreur personnalisée à l'aide de la classe CustomError, qui étend Error.
-
Lorsque CustomError est renvoyé, le constructeur l'intercepte, puis renvoie un message d'erreur à l'aide de l'instruction
trace().
package
{
import flash.display.Sprite;
public class ErrorExample extends Sprite
{
private var nullArray:Array;
public function ErrorExample()
{
try
{
nullArray.push("item");
}
catch(e:Error)
{
throw new CustomError("nullArray is null");
}
}
}
}
class CustomError extends Error
{
public function CustomError(message:String)
{
super(message);
}
}
© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 03:00 AM -08:00