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

SecurityErrorEvent  - AS3

Packageflash.events
Classepublic class SecurityErrorEvent
HéritageSecurityErrorEvent Inheritance ErrorEvent Inheritance TextEvent Inheritance Event Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Un objet distribue un objet SecurityErrorEvent pour signaler l’occurrence d’une erreur de sécurité. En règle générale, les erreurs de sécurité signalées via cette classe émanent d’opérations asynchrones, telles qu’un chargement de données, dans lesquelles les violations de la sécurité ne se manifestent pas nécessairement immédiatement. Votre écouteur d’événement peut accéder à la propriété text de l’objet pour déterminer le type d’opération tentée et les éventuelles URL concernées. En l’absence d’écouteurs d’événements, la version débogueur de Flash Player ou l’application de débogage du lanceur AIR affiche automatiquement un message d’erreur renfermant le contenu de la propriété text. Il n’existe qu’un seul type d’événement d’erreur de sécurité : SecurityErrorEvent.SECURITY_ERROR.

Les événements d’erreur de sécurité sont distribués en dernier pour tout objet cible. Par conséquent, les autres événements, en particulier ceux d’erreur générique, ne sont pas distribués pour un objet cible lié à une erreur de sécurité.

Consulter les exemples

Eléments de l’API associés



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
 InheritederrorID : int
[lecture seule] Contient le numéro de référence associé à l’erreur spécifique.
ErrorEvent
 InheritedeventPhase : uint
[lecture seule] Phase actuelle du flux d’événements.
Event
 Inheritedtarget : Object
[lecture seule] Cible de l’événement.
Event
 Inheritedtext : String
Dans le cas d’un événement textInput, caractère ou suite de caractères entré par l’utilisateur.
TextEvent
 Inheritedtype : String
[lecture seule] Type d’événement.
Event
Méthodes publiques
 MéthodeDéfini par
  
SecurityErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Crée un objet Event contenant des informations sur les événements d’erreur de sécurité.
SecurityErrorEvent
  
[override] Crée une copie de l’objet SecurityErrorEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.
SecurityErrorEvent
 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 chaîne répertoriant toutes les propriétés de l’objet SecurityErrorEvent.
SecurityErrorEvent
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
  SECURITY_ERROR : String = "securityError"
[statique] La constante SecurityErrorEvent.SECURITY_ERROR définit la valeur de la propriété type d’un objet d’événement securityError.
SecurityErrorEvent
Détails du constructeur

SecurityErrorEvent

()Constructeur
public function SecurityErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Crée un objet Event contenant des informations sur les événements d’erreur de sécurité. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.

Paramètres
type:String — Type de l’événement. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété type héritée. Il n’existe qu’un seul type d’événement d’erreur : SecurityErrorEvent.SECURITY_ERROR.
 
bubbles:Boolean (default = false) — Détermine si l’objet Event prend part à la phase de propagation du flux d’événements. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété bubbles héritée.
 
cancelable:Boolean (default = false) — Détermine si l’objet Event peut être annulé. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété cancelable héritée.
 
text:String (default = "") — Texte à afficher en tant que message d’erreur. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété text.
 
id:int (default = 0) — Numéro de référence à associer à l’erreur spécifique.

Eléments de l’API associés

Détails de la méthode

clone

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Crée une copie de l’objet SecurityErrorEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.

Valeur renvoyée
Event — Nouvel objet SecurityErrorEvent dont les propriétés ont la même valeur que celles de l’objet d’origine.

toString

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

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

Renvoie une chaîne répertoriant toutes les propriétés de l’objet SecurityErrorEvent. La chaîne est écrite au format suivant :

[securityErrorEvent type=valeur bubbles=valeur cancelable=valeur text=valeur errorID=valeur] La valeur errorId est uniquement disponible dans Adobe AIR.

Valeur renvoyée
String — Chaîne répertoriant toutes les propriétés de l’objet SecurityErrorEvent.
Détails de la constante

SECURITY_ERROR

Constante
public static const SECURITY_ERROR:String = "securityError"

Version du langage: ActionScript 3.0
Versions du moteur d’exécution: AIR 1.0, Flash Player 9, Flash Lite 4

La constante SecurityErrorEvent.SECURITY_ERROR définit la valeur de la propriété type d’un objet événement securityError.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet réseau signalant l’erreur de sécurité
textTexte à afficher en tant que message d’erreur.

Eléments de l’API associés

SecurityErrorEventExample.as

L’exemple suivant utilise la classe SecurityErrorEventExample pour montrer comment une méthode d’écouteur securityErrorHandler() peut être instanciée et définie pour écouter les événements securityError à distribuer. Cet événement se produit lorsqu’un emplacement URLRequest n’est pas exactement dans le même domaine que le fichier SWF appelant, et que le domaine demandé ne dispose pas d’une autorisation d’accès interdomaines via un fichier de régulation interdomaines.

Pour créer un objet SecurityErrorEvent, remplacez http://www.[yourdomain].com par un chemin qui ne dispose pas d’un accès interdomaines.

package {
    import flash.display.Sprite;
    import flash.net.URLLoader;
    import flash.net.URLRequest;
    import flash.events.SecurityErrorEvent;

    public class SecurityErrorEventExample extends Sprite {
        public function SecurityErrorEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);

            var request:URLRequest = new URLRequest("http://www.[yourDomain].com");
            loader.load(request);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }
    }
}




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