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.messaging.events 

ChannelFaultEvent  - AS3 BlazeDS LCDS

Packagemx.messaging.events
Classepublic class ChannelFaultEvent
HéritageChannelFaultEvent Inheritance ChannelEvent Inheritance Event Inheritance Object

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

La classe ChannelFaultEvent permet de propager des événements d’erreur de canal dans le système d’échange de messages.



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
 Inheritedchannel : Channel
Canal ayant généré cet événement.
ChannelEvent
 Inheritedconnected : Boolean
Indique si le canal ayant généré cet événement est déjà connecté.
ChannelEvent
 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
  faultCode : String
Fournit un accès au code d’erreur spécifique à la destination.
ChannelFaultEvent
  faultDetail : String
Fournit des détails spécifiques à la destination relatifs à l’erreur.
ChannelFaultEvent
  faultString : String
Fournit un accès à la cause de l’erreur spécifique à la destination.
ChannelFaultEvent
 Inheritedreconnecting : Boolean
Indique si le canal ayant généré cet événement est en train de se reconnecter.
ChannelEvent
 Inheritedrejected : Boolean
Indique si le canal ayant généré cet événement a été rejeté.
ChannelEvent
  rootCause : Object
Fournit un accès à la cause sous-jacente de l’erreur si le canal n’a pas généré l’erreur lui-même.
ChannelFaultEvent
 Inheritedtarget : Object
[lecture seule] Cible de l’événement.
Event
 Inheritedtype : String
[lecture seule] Type d’événement.
Event
Méthodes publiques
 MéthodeDéfini par
  
ChannelFaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, channel:Channel = null, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false)
Construit une instance de cet événement avec le type spécifié.
ChannelFaultEvent
  
[override] Clone la classe ChannelFaultEvent.
ChannelFaultEvent
  
Crée une classe ErrorMessage en fonction de la classe ChannelFaultEvent en copiant le code faultCode, la chaîne faultString, le détail faultDetail et la cause rootCause vers la nouvelle classe ErrorMessage.
ChannelFaultEvent
  
createEvent(channel:Channel, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false):ChannelFaultEvent
[statique] Méthode d’utilitaire permettant de créer une nouvelle classe ChannelFaultEvent qui ne se propage pas vers le haut et ne peut pas être annulée.
ChannelFaultEvent
 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 la classe ChannelFaultEvent.
ChannelFaultEvent
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
  FAULT : String = "channelFault"
[statique] Type d’événement FAULT ; indique que le canal a généré une erreur.
ChannelFaultEvent
Détails de la propriété

faultCode

propriété
public var faultCode:String

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Fournit un accès au code d’erreur spécifique à la destination. Pour obtenir des détails plus spécifiques, voir les propriétés faultString et faultDetails.

Le format des codes d’erreur est fourni par la destination distante, mais est généralement le suivant : hôte.opération.erreur ou Channel.operation.error. Par exemple, "Server.Connect.Failed" et Channel.Connect.Failed.

Channel.Connect.Failed est émis par la classe Channel et ses sous-classes (RTMPChannel, AMFChannel, HTTPChannel, etc.) chaque fois que les tentatives de connexion à la destination distante posent problème. Channel.Call.Failed est publié par la sous-classe AMFChannel lorsque le canal est déjà connecté, mais qu’il obtient un code Call.Failed à partir de sa classe NetConnection sous-jacente. Seule la classe AMFChannel écoute NetConnection.Call.Failed, qui est converti en Channel.Call.Failed.

Eléments de l’API associés

faultDetail

propriété 
public var faultDetail:String

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Fournit des détails spécifiques à la destination relatifs à l’erreur.

Les détails d’erreur standard sont une trace de pile d’une exception renvoyée au niveau de la destination distante.

Eléments de l’API associés

faultString

propriété 
public var faultString:String

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Fournit un accès à la cause de l’erreur spécifique à la destination.

Eléments de l’API associés

rootCause

propriété 
public var rootCause:Object

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Fournit un accès à la cause sous-jacente de l’erreur si le canal n’a pas généré l’erreur lui-même.

Détails du constructeur

ChannelFaultEvent

()Constructeur
public function ChannelFaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, channel:Channel = null, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false)

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Construit une instance de cet événement avec le type spécifié. Notez que les arguments rejected et connected qui correspondent à des propriétés définies par la super-classe ChannelEvent n’étaient pas initialement inclus dans cette signature de méthode et ont été ajoutés à la fin de la liste d’arguments pour préserver la rétrocompatibilité même si cette signature diffère du constructeur de la classe ChannelEvent.

Paramètres
type:String — Type d’événement.
 
bubbles:Boolean (default = false) — Indique si l’événement peut se propager vers le haut de la hiérarchie de la liste d’affichage.
 
cancelable:Boolean (default = false) — Indique si le comportement associé à l’événement peut être évité.
 
channel:Channel (default = null) — Canal générant l’événement.
 
reconnecting:Boolean (default = false) — Indique si le canal est en train de se reconnecter ou non.
 
code:String (default = null) — Code de l’erreur.
 
level:String (default = null) — Niveau de l’erreur.
 
description:String (default = null) — Description de l’erreur.
 
rejected:Boolean (default = false) — Indique si la connexion du canal a été rejetée, ce qui supprime la reconnexion automatique.
 
connected:Boolean (default = false) — Indique si le canal ayant généré cet événement est déjà connecté.
Détails de la méthode

clone

()méthode
override public function clone():Event

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Clone la classe ChannelFaultEvent.

Valeur renvoyée
Event — Copie de cette classe ChannelFaultEvent.

createErrorMessage

()méthode 
public function createErrorMessage():ErrorMessage

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Crée une classe ErrorMessage en fonction de la classe ChannelFaultEvent en copiant le code faultCode, la chaîne faultString, le détail faultDetail et la cause rootCause vers la nouvelle classe ErrorMessage.

Valeur renvoyée
ErrorMessage — Classe ErrorMessage.

createEvent

()méthode 
public static function createEvent(channel:Channel, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false):ChannelFaultEvent

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Méthode d’utilitaire permettant de créer une nouvelle classe ChannelFaultEvent qui ne se propage pas vers le haut et ne peut pas être annulée.

Paramètres

channel:Channel — Canal générant l’événement.
 
reconnecting:Boolean (default = false) — Indique si le canal est en train de se reconnecter ou non.
 
code:String (default = null) — Code de l’erreur.
 
level:String (default = null) — Niveau de l’erreur.
 
description:String (default = null) — Description de l’erreur.
 
rejected:Boolean (default = false) — Indique si la connexion du canal a été rejetée, ce qui supprime la reconnexion automatique.
 
connected:Boolean (default = false) — Indique si le canal ayant généré cet événement est déjà connecté.

Valeur renvoyée
ChannelFaultEvent — Nouvelle classe ChannelFaultEvent.

toString

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

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Renvoie une représentation de chaîne de la classe ChannelFaultEvent.

Valeur renvoyée
String — Représentation de chaîne de la classe ChannelFaultEvent.
Détails de la constante

FAULT

Constante
public static const FAULT:String = "channelFault"

Version du langage: ActionScript 3.0
Versions du produit: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Type d’événement FAULT ; indique que le canal a généré une erreur.

La valeur de cette constante est "channelFault".

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

PropriétéValeur
bubblesfalse
cancelablefalse
channelCanal ayant généré 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.
faultCodeFournit des détails spécifiques à la destination relatifs à l’erreur.
faultDetailFournit un accès à la cause de l’erreur spécifique à la destination.
faultStringFournit un accès à la cause sous-jacente de l’erreur si le canal n’a pas généré l’erreur lui-même.
reconnecting Indique si le canal ayant généré cet événement est en train de se reconnecter.
rootCause Fournit un accès à la cause sous-jacente de l’erreur si le canal n’a pas généré l’erreur lui-même.
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.





[ 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.