| Package | flash.filesystem |
| Classe | public class FileStream |
| Héritage | FileStream  EventDispatcher Object |
| Implémente | IDataInput, IDataOutput |
| Versions du moteur d’exécution: | AIR 1.0 |
open() ou de façon asynchrone en appelant la méthode openAsync().
L’avantage de l’ouverture asynchrone des fichiers est qu’un autre code peut s’exécuter pendant que Adobe AIR exécute des processus de lecture et d’écriture en arrière-plan. Dans le cas d’une ouverture asynchrone, des événements progress sont distribués au fur et à mesure des opérations.
Un objet File ouvert de façon synchrone se comporte un peu comme un objet ByteArray ; un fichier ouvert de façon asynchrone se comporte un peu comme un objet Socket ou URLStream Lorsqu’un objet File est ouvert de façon synchrone, l’appelant fait une pause pendant la lecture ou l’écriture des données demandées dans le fichier sous-jacent. Lorsqu’un fichier est ouvert de façon asynchrone, les données écrites dans le flux sont immédiatement mises en mémoire tampon et écrites ultérieurement dans le fichier.
Que la lecture d’un fichier soit synchrone ou asynchrone, les méthodes de lecture réelles sont synchrones. Dans les deux cas, elles lisent les données actuellement « disponibles ». Lorsque les données sont lues de façon synchrone, elles sont toutes disponibles à tout moment. Alors que lors d’une lecture asynchrone, les données deviennent disponibles au fur et à mesure de leur arrivée dans le tampon de lecture. Dans les deux cas, les données pouvant être lues de façon synchrone à un moment donné sont représentées par la propriété bytesAvailable.
Une application qui traite une entrée de façon asynchrone s’enregistre généralement pour les événements progress et consomme les données au fur et à mesure qu’elles deviennent disponibles en appelant des méthodes de lecture. L’application peut également se contenter d’attendre que toutes les données soient disponibles en s’enregistrant pour l’événement complete et en traitant l’ensemble des données lorsque cet événement complete est distribué.
Plus d’exemples
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
| bytesAvailable : uint [lecture seule]
Renvoie le nombre d’octets de données disponibles pour la lecture dans le tampon de saisie. | FileStream | ||
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| endian : String
Ordre d’octet des données, à savoir la constante BIG_ENDIAN ou LITTLE_ENDIAN de la classe Endian. | FileStream | ||
| objectEncoding : uint
Spécifie si le format AMF3 ou AMF0 est utilisé lors de l’écriture ou de la lecture de données binaires avec la méthode readObject() ou writeObject(). | FileStream | ||
| position : Number
Position actuelle dans le fichier. | FileStream | ||
| readAhead : Number
Quantité minimale de données à lire à partir du disque lors de la lecture asynchrone des fichiers. | FileStream | ||
| Méthode | Défini par | ||
|---|---|---|---|
Crée un objet FileStream. | FileStream | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
Ferme l’objet FileStream. | FileStream | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | |
Ouvre l’objet FileStream de façon synchrone, en pointant vers le fichier spécifié par le paramètre file. | FileStream | ||
Ouvre l’objet FileStream de façon asynchrone, en pointant vers le fichier spécifié par le paramètre file. | FileStream | ||
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
Lit une valeur booléenne dans le flux de fichiers, le flux d’octets ou le tableau d’octets. | FileStream | ||
Lit un octet signé dans le flux de fichiers, le flux d’octets ou le tableau d’octets. | FileStream | ||
Lit le nombre d’octets de données spécifié par le paramètre length dans le flux de fichiers, le flux d’octets ou le tableau d’octets. | FileStream | ||
Lit un nombre à virgule flottante à deux décimales, conforme à IEEE 754, extrait du flux de fichiers, du flux d’octets ou du tableau d’octets. | FileStream | ||
Lit un nombre à virgule flottante à une décimale, conforme à IEEE 754, extrait du flux de fichiers, du flux d’octets ou du tableau d’octets. | FileStream | ||
Lit un entier signé de 32 bits extrait du flux de fichiers, du flux d’octets ou du tableau d’octets. | FileStream | ||
Lit une chaîne multi-octets de longueur spécifiée dans le flux de fichiers, le flux d’octets ou le tableau d’octets en utilisant le jeu de caractères spécifié. | FileStream | ||
Lit un objet codé au format AMF sérialisé dans le flux de fichiers, le flux d’octets ou le tableau d’octets. | FileStream | ||
Lit un entier signé de 16 bits extrait du flux de fichiers, du flux d’octets ou du tableau d’octets. | FileStream | ||
Lit un octet non signé dans le flux de fichiers, le flux d’octets ou le tableau d’octets. | FileStream | ||
Lit un entier non signé de 32 bits extrait du flux de fichiers, du flux d’octets ou du tableau d’octets. | FileStream | ||
Lit un entier non signé de 16 bits extrait du flux de fichiers, du flux d’octets ou du tableau d’octets. | FileStream | ||
Lit une chaîne UTF-8 dans le flux de fichiers, le flux d’octets ou le tableau d’octets. | FileStream | ||
Lit une séquence d’octets UTF-8 dans le flux ou le tableau d’octets et renvoie une chaîne. | FileStream | ||
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
Tronque le fichier placé à la position spécifiée par la propriété position de l’objet FileStream. | FileStream | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
Ecrit une valeur booléenne. | FileStream | ||
Ecrit un octet. | FileStream | ||
Ecrit une séquence d’octets à partir du tableau d’octets ou des octets spécifiés, en partant de l’octet spécifié par l’offset (à l’aide d’un index de base zéro) dont la longueur est indiquée par le paramètre length dans le flux de fichiers ou d’octets, ou le tableau d’octets. | FileStream | ||
Ecrit un nombre à virgule flottante à deux décimales (64 bits) et conforme à IEEE 754. | FileStream | ||
Ecrit un nombre à virgule flottante à une décimale (32 bits) et conforme à IEEE 754. | FileStream | ||
Ecrit un entier signé de 32 bits. | FileStream | ||
Ecrit une chaîne multi-octets dans le flux de fichiers, le flux d’octets ou le tableau d’octets en utilisant le jeu de caractères spécifié. | FileStream | ||
Ecrit un objet codé au format AMF sérialisé dans le flux de fichiers, le flux d’octets ou le tableau d’octets. | FileStream | ||
Ecrit un entier de 16 bits. | FileStream | ||
Ecrit un entier non signé de 32 bits. | FileStream | ||
Ecrit une chaîne UTF-8 dans le flux de fichiers, le flux d’octets ou le tableau d’octets. | FileStream | ||
Ecrit une chaîne UTF-8. | FileStream | ||
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| Indique que le flux a été fermé par un appel explicite à la méthode close(). | FileStream | |||
| Indique que la fin du flux a été atteint. | FileStream | |||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Indique qu’une erreur s’est produite lors d’une opération d’E/S de fichier asynchrone. | FileStream | |||
| Indique que les données placées en mémoire tampon ont été écrites dans le fichier. | FileStream | |||
| Signale la disponibilité de nouvelles données dans le flux. | FileStream | |||
bytesAvailable | propriété |
bytesAvailable:uint [lecture seule] | Versions du moteur d’exécution: | AIR 1.0 |
Renvoie le nombre d’octets de données disponibles pour la lecture dans le tampon de saisie. Le code utilisateur doit appeler bytesAvailable pour garantir que les données disponibles sont suffisantes avant leur lecture à l’aide de l’une des méthodes read.
Implémentation
public function get bytesAvailable():uint endian | propriété |
objectEncoding | propriété |
objectEncoding:uint| Versions du moteur d’exécution: | AIR 1.0 |
Spécifie si le format AMF3 ou AMF0 est utilisé lors de l’écriture ou de la lecture de données binaires avec la méthode readObject() ou writeObject().
La valeur est une constante extraite de la classe ObjectEncoding. Par défaut, le format AMF3 est utilisé.
Implémentation
public function get objectEncoding():uint public function set objectEncoding(value:uint):voidEléments de l’API associés
position | propriété |
position:Number| Versions du moteur d’exécution: | AIR 1.0 |
Position actuelle dans le fichier.
Cette valeur est modifiée dans l’un des cas suivants :
- Lorsque vous définissez la propriété explicitement
- Lors d’une lecture de l’objet FileStream (avec l’une les méthodes de lecture)
- Lors d’une écriture dans l’objet FileStream
La position est définie sous forme numérique (à la place d’uint) pour que les fichiers dont la longueur est supérieure à 232 octets puissent être pris en charge. La valeur de cette propriété est toujours un nombre entier inférieur à 253. Si vous définissez cette valeur sur un nombre décimal, la valeur est arrondie au nombre entier le plus proche.
Lorsqu’un fichier est lu de façon asynchrone, si vous définissez la propriété position, l’application commence à remplir la mémoire tampon de lecture par les données en commençant à la position spécifiée, et la propriété bytesAvailable peut être définie sur 0. Attendez un événement complete avant d’utiliser une méthode de lecture pour lire des données ; ou attendez un événement progress et vérifiez la propriété bytesAvailable avant d’utiliser une méthode de lecture.
Implémentation
public function get position():Number public function set position(value:Number):voidPlus d’exemples
Mémoire tampon de lecture et propriété bytesAvailable d’un objet FileStream
Exemple ( Comment utiliser cet exemple )
position de l’objet FileStream lorsque l’application lit des données dans un fichier.
import flash.fileSystem.*;
import flash.utils.ByteArray;
import flash.events.Event;
var sourceFile:File = File.documentsDirectory.resolvePath("Apollo Test/test.txt");
var stream:FileStream = new FileStream();
stream.addEventListener(Event.COMPLETE, readBytes);
stream.openAsync(sourceFile, FileMode.READ);
function readBytes(e:Event):void {
var bytes:ByteArray = new ByteArray();
trace("position 0:", stream.position); // 0
bytes[0] = stream.readByte();
trace("position 1:", stream.position); // 1
fileStream.readBytes(bytes, stream.position, 4);
trace("position 2:", stream.position); // 5
stream.close();
}
readAhead | propriété |
readAhead:Number| Versions du moteur d’exécution: | AIR 1.0 |
Quantité minimale de données à lire à partir du disque lors de la lecture asynchrone des fichiers.
Cette propriété spécifie la quantité de données qu’un flux asynchrone tentera de lire à partir de la position actuelle. Les données sont lues en blocs en fonction de la taille de page du système de fichiers. Ainsi, si vous définissez readAhead sur 9 000 sur un système informatique dont la taille de page est de 8 Ko (8 192 octets), le moteur d’exécution lit 2 blocs ou 16 384 octets à la fois. La valeur par défaut de cette propriété est infinity : par défaut, un fichier ouvert pour une lecture asynchrone est lu jusqu’à la fin du fichier.
La lecture de données dans la mémoire tampon de lecture ne change pas la valeur de la propriété readAhead. Lorsque des données sont lues dans la mémoire tampon, de nouvelles données sont lues pour remplir la mémoire tampon de lecture.
La propriété readAhead n’a aucune incidence sur un fichier ouvert de façon synchrone.
Lorsque des données sont lues de façon asynchrone, l’objet FileStream déclenche des événements progress. Dans la méthode du gestionnaire de l’événement progress, vérifiez que le nombre requis d’octets est disponible (en vérifiant la propriété bytesAvailable), puis lisez les données dans la mémoire tampon de lecture à l’aide d’une méthode de lecture.
Implémentation
public function get readAhead():Number public function set readAhead(value:Number):voidExemple ( Comment utiliser cet exemple )
readAhead pour limiter la quantité de données lues dans un fichier à 100 octets :
import flash.filesystem.*;
var file:File = File.desktopDirectory.resolvePath("test.txt");
var fileStream:FileStream = new FileStream();
fileStream.readAhead = 100;
fileStream.addEventListener(ProgressEvent.PROGRESS, readProgressHandler)
fileStream.openAsync(file, FileMode.READ);
var results:ByteArray;
function readProgressHandler(event:ProgressEvent):void {
if (fileStream.bytesAvailable >= 100) {
fileStream.readBytes(results, 0, 100);
}
}
FileStream | () | Constructeur |
public function FileStream()| Versions du moteur d’exécution: | AIR 1.0 |
Crée un objet FileStream. Utilise la méthode open() ou openAsync() pour ouvrir un fichier.
Eléments de l’API associés
close | () | méthode |
public function close():void| Versions du moteur d’exécution: | AIR 1.0 |
Ferme l’objet FileStream.
Vous ne pouvez plus lire ni écrire des données après avoir appelé la méthode close(). Si le fichier a été ouvert de façon asynchrone (l’objet FileStream a utilisé la méthode openAsync() pour ouvrir le fichier), un appel à la méthode close() entraîne la distribution de l’événement close par l’objet.
La fermeture de l’application entraîne la fermeture automatique de tous les fichiers associés aux objets FileStream de l’application. Toutefois, il est préférable d’enregistrer un événement closed pour tous les objets FileStream ouverts de façon asynchrone et qui ont des données en attente d’écriture avant de fermer l’application (afin de s’assurer que ces données soient écrites).
Vous pouvez réutiliser l’objet FileStream en appelant la méthode open() ou la méthode openAsync(). Tous les fichiers associés à l’objet FileStream sont ainsi fermés, mais l’objet ne déclenche pas l’événement close.
Dans le cas d’un objet FileStream ouvert de façon asynchrone (avec la méthode openAsync()), même si vous appelez l’événement close() pour un objet FileStream et supprimez les propriétés et les variables qui référence l’objet, l’objet FileStream n’est pas nettoyé tant que des opérations sont en cours et que des gestionnaires d’événement sont enregistrés. En particulier, un objet FileStream non référencé autrement persiste tant que l’un des scénarios suivants est encore possible :
- Pour les opérations de lecture de fichiers, la fin du fichier n’a pas été atteinte (et l’événement
completen’a pas été déclenché). - Des données de sortie sont toujours disponibles pour l’écriture et des événements liés à la sortie (par exemple
outputProgressouioError) ont des écouteurs d’événement enregistrés.
Evénements
close: — Le fichier ouvert de façon asynchrone est fermé.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
close() de l’objet FileStream ferme le fichier lorsque les données sont écrites.
import flash.filesystem.*;
import flash.events.Event;
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.openAsync(file, FileMode.WRITE);
fileStream.writeUTFBytes("Hello");
fileStream.addEventListener(Event.CLOSE, fileClosed);
fileStream.close();
function fileClosed(event:Event):void {
trace("closed");
}
close() de l’objet FileStream ferme le fichier lorsque les données sont écrites.
import flash.filesystem.*;
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.WRITE);
fileStream.writeUTF("Hello");
fileStream.close();
open | () | méthode |
public function open(file:File, fileMode:String):void| Versions du moteur d’exécution: | AIR 1.0 |
Ouvre l’objet FileStream de façon synchrone, en pointant vers le fichier spécifié par le paramètre file.
Si l’objet FileStream est déjà ouvert, un appel à la méthode ferme le fichier avant l’ouverture et aucun autre événement (y compris close) n’est délivré pour le fichier précédemment ouvert.
Dans les systèmes qui prennent en charge le verrouillage de fichiers, un fichier ouvert en mode « écriture » ou en mode « mise à jour » (FileMode.WRITE ou FileMode.UPDATE) n’est plus lisible jusqu’à sa fermeture.
Une fois que vous avez terminé de réaliser des opérations sur le fichier, appelez la méthode close() de l’objet FileStream. Certains systèmes d’exploitation limitent le nombre de fichiers ouverts simultanément.
Paramètres
file:File — Objet File désignant le fichier à ouvrir.
| |
fileMode:String — Chaîne provenant de la classe FileMode qui définit les capacités de l’objet FileStream, par exemple la capacité à lire ou écrire dans le fichier.
|
Valeur émise
IOError — Le fichier n’existe pas ; vous ne disposez pas des autorisations appropriées pour l’ouvrir ; vous ouvrez un fichier pour un accès en lecture et vous ne disposez pas d’autorisations de lecture ; ou vous ouvrez un fichier pour un accès en écriture et vous ne disposez pas d’autorisations d’écriture.
| |
SecurityError — Le fichier se trouve dans le répertoire de l’application et le paramètre fileMode est défini sur le mode « append », « update » ou « write ».
|
Plus d’exemples
Exemple : Lecture et insertion d’un fichier XML dans un objet XML
Exemple : Lecture et écriture de données en mode aléatoire
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import flash.filesystem.*;
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.READ);
var str:String = fileStream.readMultiByte(file.size, File.systemCharset);
trace(str);
fileStream.close();
openAsync | () | méthode |
public function openAsync(file:File, fileMode:String):void| Versions du moteur d’exécution: | AIR 1.0 |
Ouvre l’objet FileStream de façon asynchrone, en pointant vers le fichier spécifié par le paramètre file.
Si l’objet FileStream est déjà ouvert, un appel à la méthode ferme le fichier avant l’ouverture et aucun autre événement (y compris close) n’est délivré pour le fichier précédemment ouvert.
Si le paramètre fileMode est défini sur FileMode.READ ou sur FileMode.UPDATE, AIR lit les données dans la mémoire tampon d’entrée dès l’ouverture du fichier, et des événements progress et open sont déclenchés au fur et à mesure de la lecture des données dans la mémoire tampon d’entrée.
Dans les systèmes qui prennent en charge le verrouillage de fichiers, un fichier ouvert en mode « écriture » ou en mode « mise à jour » (FileMode.WRITE ou FileMode.UPDATE) n’est plus lisible jusqu’à sa fermeture.
Une fois que vous avez terminé de réaliser des opérations sur le fichier, appelez la méthode close() de l’objet FileStream. Certains systèmes d’exploitation limitent le nombre de fichiers ouverts simultanément.
Paramètres
file:File — Objet File désignant le fichier à ouvrir.
| |
fileMode:String — Chaîne provenant de la classe FileMode qui définit les capacités de l’objet FileStream, par exemple la capacité à lire ou écrire dans le fichier.
|
Evénements
ioError: — Le fichier n’existe pas ; vous ne disposez pas des autorisations appropriées pour l’ouvrir ; vous ouvrez un fichier pour un accès en lecture et vous ne disposez pas d’autorisations de lecture ; ou vous ouvrez un fichier pour un accès en écriture et vous ne disposez pas d’autorisations d’écriture.
| |
progress: — Distribué lorsque les données sont lues dans la mémoire tampon d’entrée (le fichier doit être ouvert avec le paramètre fileMode défini sur FileMode.READ ou sur FileMode.UPDATE).
| |
complete: — Les données du fichier ont été lues dans la mémoire tampon d’entrée (le fichier doit être ouvert avec le paramètre fileMode défini sur FileMode.READ ou sur FileMode.UPDATE).
|
Valeur émise
SecurityError — Le fichier se trouve dans le répertoire de l’application et le paramètre fileMode est défini sur le mode « append », « update » ou « write ».
|
Plus d’exemples
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import flash.filesystem.*;
import flash.events.Event;
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.addEventListener(Event.COMPLETE, fileCompleteHandler)
fileStream.openAsync(file, FileMode.READ);
function fileCompleteHandler(event:Event):void {
var str:String = fileStream.readMultiByte(fileStream.bytesAvailable, File.systemCharset);
trace(str);
fileStream.close();
}
readBoolean | () | méthode |
public function readBoolean():Boolean| Versions du moteur d’exécution: | AIR 1.0 |
Lit une valeur booléenne dans le flux de fichiers, le flux d’octets ou le tableau d’octets. Un seul octet est lu, et la valeur true est renvoyée s’il n’est pas nul, false dans le cas contraire.
Boolean — Valeur booléenne, true si l’octet correspond à une valeur non nulle, false dans le cas contraire.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
readByte | () | méthode |
public function readByte():int| Versions du moteur d’exécution: | AIR 1.0 |
Lit un octet signé dans le flux de fichiers, le flux d’octets ou le tableau d’octets.
Valeur renvoyéeint — La valeur renvoyée est comprise entre -128 et 127.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
readBytes | () | méthode |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| Versions du moteur d’exécution: | AIR 1.0 |
Lit le nombre d’octets de données spécifié par le paramètre length dans le flux de fichiers, le flux d’octets ou le tableau d’octets. Les octets sont lus dans l’objet ByteArray spécifié par le paramètre bytes, à partir de la position indiquée par offset.
Paramètres
bytes:ByteArray — Objet ByteArray contenant les données à lire.
| |
offset:uint (default = 0)bytes où la lecture des données doit commencer.
| |
length:uint (default = 0) |
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
Plus d’exemples
readDouble | () | méthode |
public function readDouble():Number| Versions du moteur d’exécution: | AIR 1.0 |
Lit un nombre à virgule flottante à deux décimales, conforme à IEEE 754, extrait du flux de fichiers, du flux d’octets ou du tableau d’octets.
Valeur renvoyéeNumber — Nombre à virgule flottante à deux décimales et conforme au standard IEEE 754.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
readFloat | () | méthode |
public function readFloat():Number| Versions du moteur d’exécution: | AIR 1.0 |
Lit un nombre à virgule flottante à une décimale, conforme à IEEE 754, extrait du flux de fichiers, du flux d’octets ou du tableau d’octets.
Valeur renvoyéeNumber — Nombre à virgule flottante à une décimale et conforme au standard IEEE 754.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
readInt | () | méthode |
public function readInt():int| Versions du moteur d’exécution: | AIR 1.0 |
Lit un entier signé de 32 bits extrait du flux de fichiers, du flux d’octets ou du tableau d’octets.
Valeur renvoyéeint — La valeur renvoyée est comprise entre -2147483648 et 2147483647.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
readMultiByte | () | méthode |
public function readMultiByte(length:uint, charSet:String):String| Versions du moteur d’exécution: | AIR 1.0 |
Lit une chaîne multi-octets de longueur spécifiée dans le flux de fichiers, le flux d’octets ou le tableau d’octets en utilisant le jeu de caractères spécifié.
Paramètres
length:uint — Nombre d’octets à lire dans le flux d’octets.
| |
charSet:String — Chaîne désignant le le jeu de caractères à utiliser pour interpréter les octets. Parmi les chaînes de jeu de caractères possibles figurent "shift-jis", "cn-gb", "iso-8859-1", etc. Pour obtenir la liste complète, voir la section Jeux de caractères pris en charge.
Remarque : si la valeur du paramètre |
String — Chaîne au format UTF-8.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
Eléments de l’API associés
readObject | () | méthode |
public function readObject():*| Versions du moteur d’exécution: | AIR 1.0 |
Lit un objet codé au format AMF sérialisé dans le flux de fichiers, le flux d’octets ou le tableau d’octets.
Valeur renvoyée* — Objet désérialisé
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
Eléments de l’API associés
readShort | () | méthode |
public function readShort():int| Versions du moteur d’exécution: | AIR 1.0 |
Lit un entier signé de 16 bits extrait du flux de fichiers, du flux d’octets ou du tableau d’octets.
Valeur renvoyéeint — La valeur renvoyée est comprise entre -32768 et 32767.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
readUnsignedByte | () | méthode |
public function readUnsignedByte():uint| Versions du moteur d’exécution: | AIR 1.0 |
Lit un octet non signé dans le flux de fichiers, le flux d’octets ou le tableau d’octets.
Valeur renvoyéeuint — La valeur renvoyée est comprise entre 0 et 255.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
readUnsignedInt | () | méthode |
public function readUnsignedInt():uint| Versions du moteur d’exécution: | AIR 1.0 |
Lit un entier non signé de 32 bits extrait du flux de fichiers, du flux d’octets ou du tableau d’octets.
Valeur renvoyéeuint — La valeur renvoyée est comprise entre 0 et 4294967295.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
readUnsignedShort | () | méthode |
public function readUnsignedShort():uint| Versions du moteur d’exécution: | AIR 1.0 |
Lit un entier non signé de 16 bits extrait du flux de fichiers, du flux d’octets ou du tableau d’octets.
Valeur renvoyéeuint — La valeur renvoyée est comprise entre 0 et 65535.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
readUTF | () | méthode |
public function readUTF():String| Versions du moteur d’exécution: | AIR 1.0 |
Lit une chaîne UTF-8 dans le flux de fichiers, le flux d’octets ou le tableau d’octets. La chaîne doit être précédée d’un caractère non signé indiquant la longueur en octets.
Cette méthode est similaire à la méthode readUTF() de l’interface IDataInput Java®.
String — Chaîne UTF-8 générée par la représentation des caractères sous forme d’octets.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
readUTFBytes | () | méthode |
public function readUTFBytes(length:uint):String| Versions du moteur d’exécution: | AIR 1.0 |
Lit une séquence d’octets UTF-8 dans le flux ou le tableau d’octets et renvoie une chaîne.
Paramètres
length:uint — Nombre d’octets à lire.
|
String — Chaîne UTF-8 de longueur spécifiée, générée par la représentation des caractères sous forme d’octets.
|
Evénements
ioError: — Le fichier ne peut pas être lu ou n’est pas ouvert. Cet événement n’est distribué que pour les fichiers ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités de lecture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être lu (par exemple, parce qu’il est absent).
| |
EOFError — La position spécifiée pour la lecture des données excède le nombre d’octets disponibles (défini par la propriété bytesAvailable).
|
truncate | () | méthode |
public function truncate():void| Versions du moteur d’exécution: | AIR 1.0 |
Tronque le fichier placé à la position spécifiée par la propriété position de l’objet FileStream.
Les octets situés entre la position spécifiée par la propriété position et la fin du fichier sont supprimés. Le fichier doit être ouvert pour l’écriture.
Valeur émise
IllegalOperationError — Le fichier n’est pas ouvert pour l’écriture.
|
Eléments de l’API associés
Exemple ( Comment utiliser cet exemple )
import flash.filesystem.*;
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.open(file, FileMode.UPDATE);
if (file.size > 100) {
fileStream.position = 100;
fileStream.truncate();
}
fileStream.close();
var file:File = File.documentsDirectory;
file = file.resolvePath("Apollo Test/test.txt");
var fileStream:FileStream = new FileStream();
fileStream.openAsync(file, FileMode.UPDATE);
trace("start", file.size)
if (file.size > 100) {
fileStream.position = 100;
fileStream.truncate();
}
fileStream.addEventListener(Event.CLOSE, fileClosed);
fileStream.close();
function fileClosed(event:Event):void {
trace("closed", file.size);
}
writeBoolean | () | méthode |
public function writeBoolean(value:Boolean):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit une valeur booléenne. Un seul octet est écrit, conformément au paramètre value, soit 1 si true ou 0 si false.
Paramètres
value:Boolean — Valeur booléenne qui détermine l’octet écrit. Si le paramètre a pour valeur true, 1 est écrit ; s’il a pour valeur false, 0 est écrit.
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
writeByte | () | méthode |
public function writeByte(value:int):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit un octet. Les 8 bits inférieurs du paramètre sont utilisés. Les 24 bits supérieurs ne sont pas pris en compte.
Paramètres
value:int — Valeur d’octet exprimée comme un entier.
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
writeBytes | () | méthode |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit une séquence d’octets à partir du tableau d’octets ou des octets spécifiés, en partant de l’octet spécifié par l’offset (à l’aide d’un index de base zéro) dont la longueur est indiquée par le paramètre length dans le flux de fichiers ou d’octets, ou le tableau d’octets.
Si le paramètre length est omis, la longueur par défaut est utilisée (à savoir 0) et tout le contenu de la mémoire tampon à partir de offset est écrit. Si le paramètre offset est également omis, toute la mémoire tampon est écrite.
Si les paramètres offset ou length ne sont pas compris dans la plage supportée, ils sont réglés sur le début et la fin du tableau d’octets (bytes).
Paramètres
bytes:ByteArray — Tableau d’octets à écrire.
| |
offset:uint (default = 0) | |
length:uint (default = 0) |
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
writeDouble | () | méthode |
public function writeDouble(value:Number):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit un nombre à virgule flottante à deux décimales (64 bits) et conforme à IEEE 754.
Paramètres
value:Number — Nombre à virgule flottante à deux décimales (64 bits).
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
writeFloat | () | méthode |
public function writeFloat(value:Number):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit un nombre à virgule flottante à une décimale (32 bits) et conforme à IEEE 754.
Paramètres
value:Number — Nombre à virgule flottante à une décimale (32 bits).
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
writeInt | () | méthode |
public function writeInt(value:int):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit un entier signé de 32 bits.
Paramètres
value:int — Valeur d’octet exprimée comme un entier signé.
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
writeMultiByte | () | méthode |
public function writeMultiByte(value:String, charSet:String):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit une chaîne multi-octets dans le flux de fichiers, le flux d’octets ou le tableau d’octets en utilisant le jeu de caractères spécifié.
Paramètres
value:String — Valeur de la chaîne à écrire.
| |
charSet:String — Chaîne indiquant le jeu de caractères à utiliser. Parmi les chaînes de jeu de caractères possibles figurent "shift-jis", "cn-gb", "iso-8859-1", etc. Pour obtenir la liste complète, voir la section Jeux de caractères pris en charge.
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
Eléments de l’API associés
writeObject | () | méthode |
public function writeObject(object:*):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit un objet codé au format AMF sérialisé dans le flux de fichiers, le flux d’octets ou le tableau d’octets.
Paramètres
object:* — Objet à sérialiser.
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
Eléments de l’API associés
writeShort | () | méthode |
public function writeShort(value:int):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit un entier de 16 bits. Les 16 bits inférieurs du paramètre sont utilisés. Les 16 bits supérieurs ne sont pas pris en compte.
Paramètres
value:int — Valeur d’octet exprimée comme un entier.
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
writeUnsignedInt | () | méthode |
public function writeUnsignedInt(value:uint):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit un entier non signé de 32 bits.
Paramètres
value:uint — Valeur d’octet exprimée comme un entier non signé.
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
writeUTF | () | méthode |
public function writeUTF(value:String):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit une chaîne UTF-8 dans le flux de fichiers, le flux d’octets ou le tableau d’octets. La longueur de la chaîne UTF-8 exprimée en octets est d’abord écrite sous forme d’entier de 16 bits, suivi des octets représentant les caractères de la chaîne.
Paramètres
value:String — Valeur de la chaîne à écrire.
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
RangeError — Si la longueur de la chaîne est supérieure à 65535.
| |
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
writeUTFBytes | () | méthode |
public function writeUTFBytes(value:String):void| Versions du moteur d’exécution: | AIR 1.0 |
Ecrit une chaîne UTF-8. Comme writeUTF(), mais n’insère pas dans la chaîne un préfixe correspondant à un mot de 16 bits.
Paramètres
value:String — Valeur de la chaîne à écrire.
|
Evénements
ioError: — Vous ne pouvez pas écrire dans le fichier (par exemple parce qu’il est absent). Cet événement n’est distribué que pour les fichiers qui ont été ouverts pour des opérations asynchrones (avec la méthode openAsync()).
|
Valeur émise
IOError — Le fichier n’a pas été ouvert ; le fichier a été ouvert mais pas avec des capacités d’écriture ; ou, dans le cas d’un fichier ouvert pour des opérations synchrones (avec la méthode open()), le fichier ne peut pas être écrit (par exemple, parce qu’il est absent).
|
close | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.CLOSE| Versions du moteur d’exécution: | AIR 1.0 |
Indique que le flux a été fermé par un appel explicite à la méthode close().
Event.CLOSE définit la valeur de la propriété type d’un objet événement close.
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. |
target | Objet dont la connexion a été fermée. |
Eléments de l’API associés
complete | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.COMPLETE| Versions du moteur d’exécution: | AIR 1.0 |
Indique que la fin du flux a été atteint.
La constanteEvent.COMPLETE définit la valeur de la propriété type d’un objet événement complete.
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. |
target | Objet réseau dont le chargement est terminé. |
Eléments de l’API associés
ioError | Evénement |
flash.events.IOErrorEventpropriété IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Versions du moteur d’exécution: | AIR 1.0 |
Indique qu’une erreur s’est produite lors d’une opération d’E/S de fichier asynchrone.
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. |
outputProgress | Evénement |
flash.events.OutputProgressEventpropriété OutputProgressEvent.type =
flash.events.OutputProgressEvent.OUTPUT_PROGRESS| Versions du moteur d’exécution: | AIR 1.0 |
Indique que les données placées en mémoire tampon ont été écrites dans le fichier.
Définit la valeur de la propriététype d’un objet événement outputProgress.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
bytesPending | Le nombre d’octets restant à écrire au moment où l’écouteur traite l’événement. |
bytesTotal | Nombre total d’octets finalement écrits si le processus d’écriture aboutit. |
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. |
target | Objet FileStream indiquant la progression. |
progress | Evénement |
flash.events.ProgressEventpropriété ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versions du moteur d’exécution: | AIR 1.0 |
Signale la disponibilité de nouvelles données dans le flux.
Définit la valeur de la propriététype d’un objet événement progress.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
bytesLoaded | Nombre d’éléments ou d’octets chargés lors du traitement de l’événement par l’écouteur. |
bytesTotal | Nombre total d’éléments ou d’octets qui seront chargés si le processus de chargement aboutit. |
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. |
target | Objet indiquant la progression. |
Tue Jun 12 2018, 09:30 AM Z