Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
mx.rpc.events 

FaultEvent  - AS3 Flex

Packagemx.rpc.events
Classepublic class FaultEvent
HéritageFaultEvent Inheritance AbstractEvent Inheritance MessageEvent Inheritance Event Inheritance Object
Sous-classes ColdFusionServiceFaultEvent, DataServiceFaultEvent, SyncFaultEvent

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Cet événement est distribué lorsqu’un appel RPC comporte une erreur.



Propriétés publiques
 PropriétéDéfini par
 Inheritedbubbles : Boolean
[lecture seule] Indique si un événement peut se propager vers le haut (bubbling).
Event
 Inheritedcancelable : Boolean
[lecture seule] Indique si le comportement associé à l’événement peut être évité.
Event
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 InheritedcurrentTarget : Object
[lecture seule] L’objet qui traite activement l’objet Event avec un écouteur d’événements.
Event
 InheritedeventPhase : uint
[lecture seule] Phase actuelle du flux d’événements.
Event
  fault : Fault
[lecture seule] Objet d’erreur contenant les détails relatifs à l’élément ayant provoqué l’événement.
FaultEvent
  headers : Object
Dans certains cas, des en-têtes peuvent aussi être renvoyés avec une erreur pour fournir un plus grand contexte à l’échec.
FaultEvent
 Inheritedmessage : IMessage
Message associé à cet événement.
MessageEvent
  statusCode : int
[lecture seule] Si le message source a été envoyé via HTTP, cette propriété fournit l’accès au code d’état de la réponse HTTP (s’il est disponible) ; dans le cas contraire, la valeur est 0.
FaultEvent
 Inheritedtarget : Object
[lecture seule] Cible de l’événement.
Event
 Inheritedtoken : mx.rpc:AsyncToken
[lecture seule] Jeton représentant l’appel à la méthode.
AbstractEvent
 Inheritedtype : String
[lecture seule] Type d’événement.
Event
Méthodes publiques
 MéthodeDéfini par
  
FaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, fault:Fault = null, token:mx.rpc:AsyncToken = null, message:IMessage = null)
Crée un nouvel événement FaultEvent.
FaultEvent
 Inherited
[override] Clone la classe MessageEvent.
MessageEvent
  
createEvent(fault:Fault, token:mx.rpc:AsyncToken = null, msg:IMessage = null):FaultEvent
[statique] En fonction d’une erreur, cette méthode construit et renvoie un événement FaultEvent.
FaultEvent
  
[statique] En fonction d’un événement MessageFaultEvent, cette méthode construit et renvoie un événement FaultEvent.
FaultEvent
 Inherited
formatToString(className:String, ... arguments):String
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées.
Event
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Vérifie si la méthode preventDefault() a été appelée pour l’événement.
Event
 Inherited
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
 Inherited
Annule le comportement par défaut d’un événement si cette opération est possible.
Event
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements.
Event
 Inherited
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements.
Event
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
  
[override] Renvoie une représentation de chaîne de l’événement FaultEvent.
FaultEvent
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
  FAULT : String = "fault"
[statique] Type d’événement FAULT.
FaultEvent
Détails de la propriété

fault

propriété
fault:Fault  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Objet d’erreur contenant les détails relatifs à l’élément ayant provoqué l’événement.



Implémentation
    public function get fault():Fault

headers

propriété 
headers:Object

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Dans certains cas, des en-têtes peuvent aussi être renvoyés avec une erreur pour fournir un plus grand contexte à l’échec.



Implémentation
    public function get headers():Object
    public function set headers(value:Object):void

statusCode

propriété 
statusCode:int  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Si le message source a été envoyé via HTTP, cette propriété fournit l’accès au code d’état de la réponse HTTP (s’il est disponible) ; dans le cas contraire, la valeur est 0.



Implémentation
    public function get statusCode():int
Détails du constructeur

FaultEvent

()Constructeur
public function FaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, fault:Fault = null, token:mx.rpc:AsyncToken = null, message:IMessage = null)

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Crée un nouvel événement FaultEvent. L’erreur est un paramètre requis, tandis que l’appel et le message sont facultatifs.

Paramètres
type:String — Type d’événement ; indique l’action qui a déclenché l’événement.
 
bubbles:Boolean (default = false) — Détermine si l’événement peut se propager vers le haut de la hiérarchie de la liste d’affichage.
 
cancelable:Boolean (default = true) — Indique si le comportement associé à l’événement peut être évité.
 
fault:Fault (default = null) — Objet contenant les détails relatifs à l’erreur, y compris un code et une chaîne d’erreur.
 
token:mx.rpc:AsyncToken (default = null) — Jeton représentant l’appel à la méthode. Utilisé dans le modèle de jeton d’achèvement asynchrone.
 
message:IMessage (default = null) — Message source de l’erreur.
Détails de la méthode

createEvent

()méthode
public static function createEvent(fault:Fault, token:mx.rpc:AsyncToken = null, msg:IMessage = null):FaultEvent

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

En fonction d’une erreur, cette méthode construit et renvoie un événement FaultEvent.

Paramètres

fault:Fault — Erreur contenant les détails relatifs à l’événement FaultEvent.
 
token:mx.rpc:AsyncToken (default = null) — Jeton AsyncToken (facultatif) associé à cette erreur.
 
msg:IMessage (default = null) — Message (facultatif) associé à cette erreur.

Valeur renvoyée
FaultEvent — Renvoie un événement FaultEvent.

createEventFromMessageFault

()méthode 
public static function createEventFromMessageFault(value:MessageFaultEvent, token:mx.rpc:AsyncToken = null):FaultEvent

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

En fonction d’un événement MessageFaultEvent, cette méthode construit et renvoie un événement FaultEvent.

Paramètres

value:MessageFaultEvent — Référence MessageFaultEvent à partir de laquelle extraire les informations appropriées sur l’erreur.
 
token:mx.rpc:AsyncToken (default = null) — Jeton AsyncToken (facultatif) associé à cette erreur.

Valeur renvoyée
FaultEvent — Renvoie un événement FaultEvent.

toString

()méthode 
override public function toString():String

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Renvoie une représentation de chaîne de l’événement FaultEvent.

Valeur renvoyée
String — Représentation de chaîne de l’événement FaultEvent.
Détails de la constante

FAULT

Constante
public static const FAULT:String = "fault"

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Type d’événement FAULT.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelabletrue, appeler preventDefault() à partir de la méthode responder.fault du jeton associé empêchera le service ou l’opération de distribuer cet événement.
currentTargetObjet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d’événement, myButton est la valeur de currentTarget.
faultObjet d’erreur contenant les détails relatifs à l’élément ayant provoqué l’événement.
messageMessage associé à cet événement.
targetObjet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget.
tokenJeton représentant l’appel à la méthode. Utilisé dans le modèle de jeton d’achèvement asynchrone.





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.