Package | flash.events |
Classe | public class IOErrorEvent |
Héritage | IOErrorEvent ErrorEvent TextEvent Event Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Vous pouvez rechercher des événements d’erreur qui n’ont pas d’écouteurs en utilisant la version de débogage de Flash Player ou l’application de débogage du lanceur AIR (ADL). La chaîne définie par le paramètre text
du constructeur IOErrorEvent s’affiche.
Eléments de l’API associés
Méthode | Défini par | ||
---|---|---|---|
IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Crée un objet Event contenant des informations spécifiques sur les événements ioError. | IOErrorEvent | ||
[override]
Crée une copie de l’objet IOErrorEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine. | IOErrorEvent | ||
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Vérifie si la méthode preventDefault() a été appelée pour l’événement. | Event | ||
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 | ||
Annule le comportement par défaut d’un événement si cette opération est possible. | Event | ||
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 | ||
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements. | Event | ||
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 | ||
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 IOErrorEvent. | IOErrorEvent | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
Constante | Défini par | ||
---|---|---|---|
IO_ERROR : String = "ioError" [statique]
Définit la valeur de la propriété type d’un objet d’événement ioError. | IOErrorEvent | ||
STANDARD_ERROR_IO_ERROR : String = "standardErrorIoError" [statique]
L’événement standardErrorIoError est distribué lorsqu’une erreur se produit pendant la lecture des données du flux d’erreurs standard d’un l’objet NativeProcess. | IOErrorEvent | ||
STANDARD_INPUT_IO_ERROR : String = "standardInputIoError" [statique]
L’événement standardInputIoError est distribué lorsqu’une erreur se produit pendant l’écriture des données dans la propriété standardInput d’un objet NativeProcess. | IOErrorEvent | ||
STANDARD_OUTPUT_IO_ERROR : String = "standardOutputIoError" [statique]
L’événement standardOutputIoError est distribué lorsqu’une erreur se produit pendant la lecture des données du flux de sortie standard d’un l’objet NativeProcess. | IOErrorEvent |
IOErrorEvent | () | Constructeur |
public function IOErrorEvent(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 d’événement contenant des informations spécifiques sur les événements ioError
. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événement.
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 d’entrée/sortie : IOErrorEvent.IO_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 ) — Un numéro de référence à associer à l’erreur spécifique (pris en charge uniquement par Adobe AIR).
|
Eléments de l’API associés
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 IOErrorEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.
Valeur renvoyéeEvent — Nouvel objet IOErrorEvent 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 IOErrorEvent. La chaîne est écrite au format suivant :
[IOErrorEvent type=valeur bubbles=valeur cancelable=valeur text=valeur errorID=valeur]
La valeur errorId
est uniquement disponible dans Adobe AIR.
String — Chaîne répertoriant toutes les propriétés de l’objet IOErrorEvent.
|
IO_ERROR | Constante |
public static const IO_ERROR:String = "ioError"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Définit la valeur de la propriété type
d’un objet d’événement ioError
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
errorID | Un numéro de référence associé à l’erreur spécifique (AIR uniquement). |
target | Objet réseau sur lequel l’erreur d’entrée/sortie s’est produite. |
text | Texte à afficher en tant que message d’erreur. |
Eléments de l’API associés
STANDARD_ERROR_IO_ERROR | Constante |
public static const STANDARD_ERROR_IO_ERROR:String = "standardErrorIoError"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 2, Flash Lite 4 |
L’événement standardErrorIoError
est distribué lorsqu’une erreur se produit pendant la lecture des données du flux d’erreurs standard d’un l’objet NativeProcess.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | N° |
cancelable | No. Il n’existe aucun comportement par défaut à annuler. |
errorID | Numéro de référence associé à l’erreur spécifique. |
target | Objet sur lequel l’erreur est survenue. |
text | Texte à afficher en tant que message d’erreur. |
STANDARD_INPUT_IO_ERROR | Constante |
public static const STANDARD_INPUT_IO_ERROR:String = "standardInputIoError"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 2, Flash Lite 4 |
L’événement standardInputIoError
est distribué lorsqu’une erreur se produit pendant l’écriture des données dans la propriété standardInput d’un objet NativeProcess.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | N° |
cancelable | No. Il n’existe aucun comportement par défaut à annuler. |
errorID | Numéro de référence associé à l’erreur spécifique. |
target | Objet sur lequel l’erreur est survenue. |
text | Texte à afficher en tant que message d’erreur. |
STANDARD_OUTPUT_IO_ERROR | Constante |
public static const STANDARD_OUTPUT_IO_ERROR:String = "standardOutputIoError"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 2, Flash Lite 4 |
L’événement standardOutputIoError
est distribué lorsqu’une erreur se produit pendant la lecture des données du flux de sortie standard d’un l’objet NativeProcess.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | N° |
cancelable | No. Il n’existe aucun comportement par défaut à annuler. |
errorID | Numéro de référence associé à l’erreur spécifique. |
target | Objet sur lequel l’erreur est survenue. |
text | Texte à afficher en tant que message d’erreur. |
IOErrorEventExample
pour montrer comment l’objet d’événement error est distribué en cas de tentative de chargement d’un fichier non existant. L’exemple exécute les tâches suivantes :
- Le constructeur de classe crée une nouvelle occurrence de l’objet URLLoader et l’affecte à la variable
loader
. - L’occurrence URLLoader instancie un écouteur d’événements de type
ioError
, associé à une méthode d’abonnéioErrorHandler()
, qui imprime simplement des informations sur l’événement à l’aide de l’instructiontrace()
. - Le constructeur crée ensuite une nouvelle occurrence d’objet URLRequest,
request
, en transmettantMissingFile.xml
de manière à faire connaître le nom et l’emplacement du fichier manquant. - La variable
request
est ensuite transmis àloader.load()
, qui tente de charger le fichier manquant. Le fichier n’existant pas, le gestionnaire d’événements distribue un événementioError
.
Remarques :
- Vous devrez compiler le fichier SWF en définissant « Sécurité de lecture locale » sur « Accès aux fichiers locaux uniquement ».
- Assurez-vous que aucun fichier nommé « MissingFile.xml » ne se situe au même niveau que votre fichier SWF.
package { import flash.display.Sprite; import flash.events.IOErrorEvent; import flash.net.URLLoader; import flash.net.URLRequest; public class IOErrorEventExample extends Sprite { public function IOErrorEventExample() { var loader:URLLoader = new URLLoader(); loader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); var request:URLRequest = new URLRequest("MissingFile.xml"); loader.load(request); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } } }
Tue Jun 12 2018, 09:30 AM Z