| Pacchetto | flash.filesystem |
| Classe | public class FileStream |
| Ereditarietà | FileStream  EventDispatcher Object |
| Implementa | IDataInput, IDataOutput |
| Versioni runtime: | AIR 1.0 |
open() oppure in modo asincrono mediante chiamata del metodo openAsync().
Il vantaggio di aprire i file modo asincrono è che altro codice può essere eseguito mentre Adobe AIR esegue processi di lettura e scrittura in background. Se i file vengono aperti in modo asincrono, col procedere delle operazioni vengono inviati eventi progress.
Un oggetto File aperto in modo sincrono si comporta come un oggetto ByteArray, mentre un file aperto in modo asincrono si comporta come un oggetto Socket o URLStream. Se un oggetto File viene aperto in modo sincrono, il chiamante resterà in pausa mentre i dati richiesti vengono letti dal o scritti sul file sottostante. Se un file viene aperto in modo sincrono, i dati scritti nel flusso vengono immediatamente inseriti nel buffer, quindi scritti sul file in un secondo momento.
Sia che i dati vengano letti da un file in modo sincrono o asincrono, gli effettivi metodi di lettura sono sincroni. In entrambi i casi, vengono letti dati immediatamente "disponibili". La differenza è che quando si legge in modo sincrono, tutti i dati sono disponibili costantemente, mentre quando si legge in modo asincrono, i dati diventano disponibili gradualmente a mano a mano che vengono caricati in un buffer di lettura. In entrambi i casi, i dati che possono essere letti in modo sincrono nel momento corrente sono rappresentati dalla proprietà bytesAvailable.
Un'applicazione che elabora input asincroni generalmente si registra per eventi progress e consuma i dati a mano a mano che diventano disponibili chiamando metodi di lettura. In alternativa, un'applicazione può semplicemente attendere fino a quando tutti i dati si rendono disponibili registrandosi per l'evento complete ed elaborare l'intera serie di dati quando viene inviato l'evento complete.
Altri esempi
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| bytesAvailable : uint [sola lettura]
Restituisce il numero di byte dei dati disponibili per la lettura nel buffer di input. | FileStream | ||
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| endian : String
L'ordine dei byte dei dati: costante BIG_ENDIAN o LITTLE_ENDIAN della classe Endian. | FileStream | ||
| objectEncoding : uint
Specifica se impiegare il formato AMF3 o AMF0 durante la scrittura o lettura di dati binari mediante il metodo readObject() o writeObject(). | FileStream | ||
| position : Number
La posizione corrente nel file. | FileStream | ||
| readAhead : Number
La quantità minima di dati da leggere da disco quando i file vengono letti in modalità asincrona. | FileStream | ||
| Metodo | Definito da | ||
|---|---|---|---|
Crea un oggetto FileStream. | FileStream | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
Chiude l'oggetto FileStream. | FileStream | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
Apre l'oggetto FileStream in modo sincrono, puntando al file specificato dal parametro file. | FileStream | ||
Apre l'oggetto FileStream in modo asincrono, puntando al file specificato dal parametro file. | FileStream | ||
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
Legge un valore booleano dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge un byte con segno dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge il numero di byte di dati, specificato dal parametro length, dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge un numero a virgola mobile IEEE 754 a precisione doppia dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge un numero a virgola mobile IEEE 754 a precisione singola dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge un numero intero a 32 bit con segno dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge una stringa multibyte di lunghezza specificata dal flusso di file oppure dal flusso o array di byte mediante il set di caratteri specificato. | FileStream | ||
Legge un oggetto dal flusso di file oppure dal flusso o array di byte, codificato nel formato serializzato AMF. | FileStream | ||
Legge un numero intero a 16 bit con segno dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge un byte senza segno dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge un numero intero a 32 bit senza segno dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge un numero intero a 16 bit senza segno dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge una stringa UTF-8 dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Legge una sequenza di byte UTF-8 dal flusso o dall'array di byte e restituisce una stringa. | FileStream | ||
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
Tronca il file nella posizione specificata dalla proprietà position dell'oggetto FileStream. | FileStream | ||
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
Scrive un valore booleano. | FileStream | ||
Scrive un byte. | FileStream | ||
Scrive una sequenza di byte dall'array di byte specificato, bytes, iniziando dal byte specificato da offset (utilizzando un indice a base zero) con la lunghezza specificata da length, nel flusso di file oppure nel flusso o array di byte. | FileStream | ||
Scrive un numero a virgola mobile IEEE 754 a precisione doppia (64 bit). | FileStream | ||
Scrive un numero a virgola mobile IEEE 754 a precisione singola (32 bit). | FileStream | ||
Scrive un numero intero con segno a 32 bit. | FileStream | ||
Scrive una stringa multibyte nel flusso di file oppure nel flusso o array di byte mediante il set di caratteri specificato. | FileStream | ||
Scrive un oggetto nel flusso di file oppure nel flusso o array di byte nel formato serializzato AMF. | FileStream | ||
Scrive un numero intero a 16 bit. | FileStream | ||
Scrive un numero intero senza segno a 32 bit. | FileStream | ||
Legge una stringa UTF-8 dal flusso di file oppure dal flusso o array di byte. | FileStream | ||
Scrive una stringa UTF-8. | FileStream | ||
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | ||
| Indica che il flusso è stato chiuso da una chiamata esplicita al metodo close(). | FileStream | |||
| Segnala che è stata raggiunta la fine del flusso. | FileStream | |||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Indica che si è verificato un errore durante un'operazione I/O file asincrona. | FileStream | |||
| Segnala che i dati del buffer sono stati scritti nel file. | FileStream | |||
| Segnala la disponibilità di nuovi dati nel flusso. | FileStream | |||
bytesAvailable | proprietà |
bytesAvailable:uint [sola lettura] | Versioni runtime: | AIR 1.0 |
Restituisce il numero di byte dei dati disponibili per la lettura nel buffer di input. Il codice utente deve chiamare bytesAvailable per verificare che i dati disponibili siano sufficienti prima di tentare di leggerli mediante uno dei metodi di lettura.
Implementazione
public function get bytesAvailable():uint endian | proprietà |
objectEncoding | proprietà |
objectEncoding:uint| Versioni runtime: | AIR 1.0 |
Specifica se impiegare il formato AMF3 o AMF0 durante la scrittura o lettura di dati binari mediante il metodo readObject() o writeObject().
Questo valore è una costante della classe ObjectEncoding. Per impostazione predefinita, il formato utilizzato è AMF3.
Implementazione
public function get objectEncoding():uint public function set objectEncoding(value:uint):voidElementi API correlati
position | proprietà |
position:Number| Versioni runtime: | AIR 1.0 |
La posizione corrente nel file.
Questo valore viene modificato in uno dei modi seguenti:
- quando impostate la proprietà in modo esplicito;
- durante la lettura dall'oggetto FileStream (utilizzando uno dei metodi di lettura);
- durante la scrittura sull'oggetto FileStream.
La posizione viene definita come numero (anziché come unità) per poter supportare file di lunghezza superiore a 232 byte. Il valore di questa proprietà è sempre un numero intero inferiore a 253. Se impostate questo valore su un numero decimale, il valore viene arrotondato sul numero intero più vicino.
Durante la lettura di un file in modo asincrono, se impostate la proprietà position, l'applicazione inizierà a riempire il buffer di lettura con i dati a partire dalla posizione specificata e la proprietà bytesAvailable può essere impostata su 0. Prima di utilizzare un metodo di lettura per leggere i dati, aspettate di ricevere un evento complete; oppure aspettate un evento progress e verificate la proprietà bytesAvailable prima di usare il metodo di lettura.
Implementazione
public function get position():Number public function set position(value:Number):voidAltri esempi
Buffer di lettura e proprietà bytesAvailable di un oggetto FileStream
Esempio ( Come utilizzare questo esempio )
position di un oggetto FileStream viene aggiornata, man mano che l'applicazione legge i dati da un file.
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 | proprietà |
readAhead:Number| Versioni runtime: | AIR 1.0 |
La quantità minima di dati da leggere da disco quando i file vengono letti in modalità asincrona.
Questa proprietà specifica la quantità di dati che un flusso asincrono tenta di leggere oltre la posizione corrente. I dati vengono letti a blocchi in base alla dimensione di pagina del file system. Quindi, se impostate readAhead su 9,000 su un computer con dimensione pagina di 8 KB (8192 byte), il runtime legge 2 blocchi (16384 byte) alla volta. Il valore predefinito di questa proprietà è infinito; per impostazione predefinita, un file aperto per la lettura asincrona continua a leggere fino alla fine del file.
La lettura dei dati dal buffer di lettura non modifica il valore della proprietà readAhead. Durante la lettura dei dati dal buffer, i nuovi dati vengono letti all'interno del buffer per riempirlo.
La proprietà readAhead non ha alcun effetto su un file aperto in modo sincrono.
A mano a mano che i dati vengono letti in modo asincrono, l'oggetto FileStream invia eventi progress. Nel metodo del gestore eventi per l'evento progress, controllate che il numero di byte richiesto sia disponibile (verificando la proprietà bytesAvailable), quindi leggete i dati dal buffer di lettura mediante uno dei metodo di lettura.
Implementazione
public function get readAhead():Number public function set readAhead(value:Number):voidEsempio ( Come utilizzare questo esempio )
readAhead per limitare a 100 byte la quantità di dati da leggere in un file:
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 | () | Funzione di costruzione |
public function FileStream()| Versioni runtime: | AIR 1.0 |
Crea un oggetto FileStream. Utilizzate il metodo open() o openAsync() per aprire un file.
Elementi API correlati
close | () | metodo |
public function close():void| Versioni runtime: | AIR 1.0 |
Chiude l'oggetto FileStream.
Non è possibile leggere o scrivere dati dopo aver chiamato il metodo close(). Se il file è stato aperto in modo asincrono (l'oggetto FileStream ha usato il metodo openAsync() per aprire il file), una chiamata al metodo close() provoca l'invio dell'evento close da parte dell'oggetto.
Se l'applicazione viene chiusa, tutti i file associati a oggetti FileStream nell'applicazione vengono automaticamente chiusi. Tuttavia, è consigliabile registrare per un evento closed tutti gli oggetti FileStream aperti in modo asincrono che presentano dati in attesa di scrittura prima di chiudere l'applicazione (per assicurare che i dati vengano scritti).
Potete riutilizzare l'oggetto FileStream chiamando il metodo open() o openAsync(). In questo modo, vengono chiusi tutti i file associati all'oggetto FileStream, ma l'oggetto non invierà l'evento close.
Per un oggetto FileStream aperto in modo asincrono (utilizzando il metodo openAsync()), anche se chiamate l'evento close() per l'oggetto FileStream e vengono cancellate tutte le proprietà e le variabili che fanno riferimento all'oggetto, l'oggetto FileStream non viene sottoposto a garbage collection fintanto che vi sono operazioni in attesa e gestori di eventi registrati per il loro completamento. In particolare, un oggetto FileStream senza alcun riferimento continua a persistere fintanto che sono possibili le seguenti operazioni:
- per operazioni di lettura file, la fine del file non è stata raggiunta (e l'evento
completenon è stato inviato); - sono ancora disponibili dati in uscita da scrivere ed eventi relativi a dati in uscita (quali l'evento
outputProgresso l'eventoioError) presentano listener di eventi registrati.
Eventi
close: — Il file che era stato aperto in modo asincrono è chiuso.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
close() dell'oggetto FileStream consente di chiudere il file quando i dati sono stati scritti.
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() dell'oggetto FileStream consente di chiudere il file quando i dati sono stati scritti.
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 | () | metodo |
public function open(file:File, fileMode:String):void| Versioni runtime: | AIR 1.0 |
Apre l'oggetto FileStream in modo sincrono, puntando al file specificato dal parametro file.
Se l'oggetto FileStream è già aperto, la chiamata di questo metodo chiude il file prima dell'apertura e nessun altro evento (incluso close) viene inviato per il file precedentemente aperto.
In sistemi che supportano il blocco dei file, un file aperto in modalità "write" o "update" (FileMode.WRITE o FileMode.UPDATE) non è leggibile fino a quando non viene chiuso.
Una volta completate tutte le operazioni sul file, chiamate il metodo close() dell'oggetto FileStream. Alcuni sistemi operativi limitano il numero di file aperti contemporaneamente.
Parametri
file:File — L'oggetto File che specifica il file da aprire.
| |
fileMode:String — Una stringa della classe FileMode che definisce le funzionalità di FileStream, ad esempio, la capacità di leggere da o scrivere su un file.
|
Genera
IOError — Il file non esiste; non disponete di autorizzazioni sufficienti per aprire il file; state cercando di aprire un file con accesso in lettura e non disponete delle autorizzazioni adeguate; oppure state cercando di aprire un file con accesso in scrittura e non disponete delle autorizzazioni adeguate.
| |
SecurityError — La posizione del file è nella directory dell'applicazione e il parametro fileMode è impostato sulla modalità "append", "update" o "write".
|
Altri esempi
Esempio: lettura di un file XML in un oggetto XML
Esempio: lettura e scrittura di dati con accesso casuale
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
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 | () | metodo |
public function openAsync(file:File, fileMode:String):void| Versioni runtime: | AIR 1.0 |
Apre l'oggetto FileStream in modo asincrono, puntando al file specificato dal parametro file.
Se l'oggetto FileStream è già aperto, la chiamata di questo metodo chiude il file prima dell'apertura e nessun altro evento (incluso close) viene inviato per il file precedentemente aperto.
Se il parametro fileMode è impostato su FileMode.READ o FileMode.UPDATE, AIR legge i dati nel buffer di ingresso non appena il file viene aperto e gli eventi progress e open vengono inviati man mano che i dati vengono letti nel buffer di ingresso.
In sistemi che supportano il blocco dei file, un file aperto in modalità "write" o "update" (FileMode.WRITE o FileMode.UPDATE) non è leggibile fino a quando non viene chiuso.
Una volta completate tutte le operazioni sul file, chiamate il metodo close() dell'oggetto FileStream. Alcuni sistemi operativi limitano il numero di file aperti contemporaneamente.
Parametri
file:File — L'oggetto File che specifica il file da aprire.
| |
fileMode:String — Una stringa della classe FileMode che definisce le funzionalità di FileStream, ad esempio, la capacità di leggere da o scrivere su un file.
|
Eventi
ioError: — Il file non esiste; non disponete di autorizzazioni sufficienti per aprire il file; state cercando di aprire un file con accesso in lettura e non disponete delle autorizzazioni adeguate; oppure state cercando di aprire un file con accesso in scrittura e non disponete delle autorizzazioni adeguate.
| |
progress: — Inviato quando i dati vengono letti nel buffer di ingresso (Il file deve essere aperto con il parametro fileMode impostato su FileMode.READ o FileMode.UPDATE.)
| |
complete: — I dati del file sono stati letti nel buffer di ingresso (Il file deve essere aperto con il parametro fileMode impostato su FileMode.READ o FileMode.UPDATE.)
|
Genera
SecurityError — La posizione del file è nella directory dell'applicazione e il parametro fileMode è impostato sulla modalità "append", "update" o "write".
|
Altri esempi
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
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 | () | metodo |
public function readBoolean():Boolean| Versioni runtime: | AIR 1.0 |
Legge un valore booleano dal flusso di file oppure dal flusso o array di byte. Viene letto un byte singolo e, se è diverso da zero, viene restituito true (false, in caso contrario).
Boolean — Un valore booleano: true se il byte è diverso da zero, false in caso contrario.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
readByte | () | metodo |
public function readByte():int| Versioni runtime: | AIR 1.0 |
Legge un byte con segno dal flusso di file oppure dal flusso o array di byte.
Restituisceint — Il valore restituito è compreso nell'intervallo da -128 a 127.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
readBytes | () | metodo |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| Versioni runtime: | AIR 1.0 |
Legge il numero di byte di dati, specificato dal parametro length, dal flusso di file oppure dal flusso o array di byte. I byte vengono letti nell'oggetto ByteArray specificato dal parametro bytes, a partire dalla posizione specificata da offset.
Parametri
bytes:ByteArray — L'oggetto ByteArray in cui vengono letti i dati.
| |
offset:uint (default = 0)bytes dal quale deve iniziare la lettura dati.
| |
length:uint (default = 0) |
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
Altri esempi
readDouble | () | metodo |
public function readDouble():Number| Versioni runtime: | AIR 1.0 |
Legge un numero a virgola mobile IEEE 754 a precisione doppia dal flusso di file oppure dal flusso o array di byte.
RestituisceNumber — Un numero a virgola mobile IEEE 754 a precisione doppia.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
readFloat | () | metodo |
public function readFloat():Number| Versioni runtime: | AIR 1.0 |
Legge un numero a virgola mobile IEEE 754 a precisione singola dal flusso di file oppure dal flusso o array di byte.
RestituisceNumber — Un numero a virgola mobile IEEE 754 a precisione singola.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
readInt | () | metodo |
public function readInt():int| Versioni runtime: | AIR 1.0 |
Legge un numero intero a 32 bit con segno dal flusso di file oppure dal flusso o array di byte.
Restituisceint — Il valore restituito è compreso nell'intervallo da -2147483648 a 2147483647.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
readMultiByte | () | metodo |
public function readMultiByte(length:uint, charSet:String):String| Versioni runtime: | AIR 1.0 |
Legge una stringa multibyte di lunghezza specificata dal flusso di file oppure dal flusso o array di byte mediante il set di caratteri specificato.
Parametri
length:uint — Il numero di byte dal flusso di byte da leggere.
| |
charSet:String — La stringa che indica il set di caratteri da utilizzare per interpretare i byte. Le stringhe dei set di caratteri possono essere "shift-jis", "cn-gb", "iso-8859-1" e altre. Per un elenco completo, vedete Set di caratteri supportati.
Nota: se il valore del parametro |
String — Stringa con codifica UTF-8.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
Elementi API correlati
readObject | () | metodo |
public function readObject():*| Versioni runtime: | AIR 1.0 |
Legge un oggetto dal flusso di file oppure dal flusso o array di byte, codificato nel formato serializzato AMF.
Restituisce* — L'oggetto deserializzato.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
Elementi API correlati
readShort | () | metodo |
public function readShort():int| Versioni runtime: | AIR 1.0 |
Legge un numero intero a 16 bit con segno dal flusso di file oppure dal flusso o array di byte.
Restituisceint — Il valore restituito è compreso nell'intervallo da -32768 a 32767.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
readUnsignedByte | () | metodo |
public function readUnsignedByte():uint| Versioni runtime: | AIR 1.0 |
Legge un byte senza segno dal flusso di file oppure dal flusso o array di byte.
Restituisceuint — Il valore restituito è compreso nell'intervallo da 0 a 255.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
readUnsignedInt | () | metodo |
public function readUnsignedInt():uint| Versioni runtime: | AIR 1.0 |
Legge un numero intero a 32 bit senza segno dal flusso di file oppure dal flusso o array di byte.
Restituisceuint — Il valore restituito è compreso nell'intervallo da 0 a 4294967295.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
readUnsignedShort | () | metodo |
public function readUnsignedShort():uint| Versioni runtime: | AIR 1.0 |
Legge un numero intero a 16 bit senza segno dal flusso di file oppure dal flusso o array di byte.
Restituisceuint — Il valore restituito è compreso nell'intervallo da 0 a 65535.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
readUTF | () | metodo |
public function readUTF():String| Versioni runtime: | AIR 1.0 |
Legge una stringa UTF-8 dal flusso di file oppure dal flusso o array di byte. Si presume che la stringa abbia come prefisso una dichiarazione unsigned short, che indica la lunghezza in byte.
Questo metodo è simile al metodo readUTF() dell'interfaccia Java® IDataInput.
String — Una stringa UTF-8 prodotta dalla rappresentazione in byte di caratteri.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
readUTFBytes | () | metodo |
public function readUTFBytes(length:uint):String| Versioni runtime: | AIR 1.0 |
Legge una sequenza di byte UTF-8 dal flusso o dall'array di byte e restituisce una stringa.
Parametri
length:uint — Il numero di byte da leggere.
|
String — Una stringa UTF-8 prodotta dalla rappresentazione in byte di caratteri della lunghezza specificata.
|
Eventi
ioError: — Il file non può essere letto o il file non è aperto. Questo evento viene inviato solo per file aperti per operazioni asincrone (utilizzando il metodo openAsync).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di lettura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere letto (ad esempio, perché mancante).
| |
EOFError — La posizione specificata per la lettura dei dati supera il numero di byte disponibili (specificato dalla proprietà bytesAvailable).
|
truncate | () | metodo |
public function truncate():void| Versioni runtime: | AIR 1.0 |
Tronca il file nella posizione specificata dalla proprietà position dell'oggetto FileStream.
I byte dalla posizione specificata dalla proprietà position fino alla fine del file vengono eliminati. Il file deve essere aperto per la scrittura.
Genera
IllegalOperationError — Il file non è aperto per la scrittura.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
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 | () | metodo |
public function writeBoolean(value:Boolean):void| Versioni runtime: | AIR 1.0 |
Scrive un valore booleano. Viene scritto un singolo byte a seconda del parametro value: 1 se true oppure 0 se false.
Parametri
value:Boolean — Un valore booleano che determina il byte da scrivere. Se il parametro è true, viene scritto 1; se false, viene scritto 0.
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
writeByte | () | metodo |
public function writeByte(value:int):void| Versioni runtime: | AIR 1.0 |
Scrive un byte. Vengono utilizzati i 8 bit inferiori del parametro; i 24 bit superiori vengono ignorati.
Parametri
value:int — Un valore byte come un numero intero.
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
writeBytes | () | metodo |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| Versioni runtime: | AIR 1.0 |
Scrive una sequenza di byte dall'array di byte specificato, bytes, iniziando dal byte specificato da offset (utilizzando un indice a base zero) con la lunghezza specificata da length, nel flusso di file oppure nel flusso o array di byte.
Se il parametro length viene omesso, viene utilizzata la lunghezza predefinita 0 e viene scritto l'intero buffer partendo da offset. Se viene omesso anche il parametro offset, viene scritto l'intero buffer.
Se il parametro offset o length è fuori intervallo, viene fissato all'inizio e alla fine dell'array bytes.
Parametri
bytes:ByteArray — L'array di byte da scrivere.
| |
offset:uint (default = 0) | |
length:uint (default = 0) |
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
writeDouble | () | metodo |
public function writeDouble(value:Number):void| Versioni runtime: | AIR 1.0 |
Scrive un numero a virgola mobile IEEE 754 a precisione doppia (64 bit).
Parametri
value:Number — Un numero a virgola mobile a precisione doppia (64 bit).
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
writeFloat | () | metodo |
public function writeFloat(value:Number):void| Versioni runtime: | AIR 1.0 |
Scrive un numero a virgola mobile IEEE 754 a precisione singola (32 bit).
Parametri
value:Number — Un numero a virgola mobile a precisione singola (32 bit).
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
writeInt | () | metodo |
public function writeInt(value:int):void| Versioni runtime: | AIR 1.0 |
Scrive un numero intero con segno a 32 bit.
Parametri
value:int — Un valore byte come un numero intero con segno.
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
writeMultiByte | () | metodo |
public function writeMultiByte(value:String, charSet:String):void| Versioni runtime: | AIR 1.0 |
Scrive una stringa multibyte nel flusso di file oppure nel flusso o array di byte mediante il set di caratteri specificato.
Parametri
value:String — Il valore stringa da scrivere.
| |
charSet:String — La stringa che indica il set di caratteri da utilizzare. Le stringhe dei set di caratteri possono essere "shift-jis", "cn-gb", "iso-8859-1" e altre. Per un elenco completo, vedete Set di caratteri supportati.
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
Elementi API correlati
writeObject | () | metodo |
public function writeObject(object:*):void| Versioni runtime: | AIR 1.0 |
Scrive un oggetto nel flusso di file oppure nel flusso o array di byte nel formato serializzato AMF.
Parametri
object:* — L'oggetto da serializzare.
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
Elementi API correlati
writeShort | () | metodo |
public function writeShort(value:int):void| Versioni runtime: | AIR 1.0 |
Scrive un numero intero a 16 bit. Vengono utilizzati i 16 bit inferiori del parametro; i 16 bit superiori vengono ignorati.
Parametri
value:int — Un valore byte come un numero intero.
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
writeUnsignedInt | () | metodo |
public function writeUnsignedInt(value:uint):void| Versioni runtime: | AIR 1.0 |
Scrive un numero intero senza segno a 32 bit.
Parametri
value:uint — Un valore byte come un numero intero senza segno.
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
writeUTF | () | metodo |
public function writeUTF(value:String):void| Versioni runtime: | AIR 1.0 |
Legge una stringa UTF-8 dal flusso di file oppure dal flusso o array di byte. La lunghezza della stringa UTF-8 in byte viene scritta per prima, come numero intero a 16 bit, seguita dai byte che rappresentano i caratteri della stringa.
Parametri
value:String — Il valore stringa da scrivere.
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
RangeError — Se la lunghezza della stringa è maggiore di 65535.
| |
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
writeUTFBytes | () | metodo |
public function writeUTFBytes(value:String):void| Versioni runtime: | AIR 1.0 |
Scrive una stringa UTF-8. È simile a writeUTF(), ma non inserisce come prefisso della stringa una parola di 16 bit.
Parametri
value:String — Il valore stringa da scrivere.
|
Eventi
ioError: — Non è possibile scrivere sul file (ad esempio, perché il file è mancante). Questo evento viene inviato solo per file che sono stati aperti per operazioni asincrone (utilizzando il metodo openAsync()).
|
Genera
IOError — Il file non è stato aperto; il file è stato aperto, ma non con funzionalità di scrittura; oppure, per un file aperto per operazioni sincrone (utilizzando il metodo open()), il file non può essere scritto (ad esempio, perché mancante).
|
close | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.CLOSE| Versioni runtime: | AIR 1.0 |
Indica che il flusso è stato chiuso da una chiamata esplicita al metodo close().
Event.CLOSE definisce il valore della proprietà type di un oggetto evento close.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto la cui connessione è stata chiusa. |
Elementi API correlati
complete | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.COMPLETE| Versioni runtime: | AIR 1.0 |
Segnala che è stata raggiunta la fine del flusso.
La costanteEvent.COMPLETE definisce il valore della proprietà type di un oggetto evento complete.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete che ha completato il caricamento. |
Elementi API correlati
ioError | Evento |
flash.events.IOErrorEventproprietà IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Versioni runtime: | AIR 1.0 |
Indica che si è verificato un errore durante un'operazione I/O file asincrona.
Definisce il valore della proprietàtype di un oggetto evento ioError.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
errorID | Un numero di riferimento associato all'errore specifico (solo AIR). |
target | L'oggetto di rete interessato dall'errore di input/output. |
text | Testo da visualizzare come messaggio di errore. |
outputProgress | Evento |
flash.events.OutputProgressEventproprietà OutputProgressEvent.type =
flash.events.OutputProgressEvent.OUTPUT_PROGRESS| Versioni runtime: | AIR 1.0 |
Segnala che i dati del buffer sono stati scritti nel file.
Definisce il valore della proprietàtype di un oggetto evento outputProgress.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
bytesPending | Il numero byte che rimangono da scrivere nel momento in cui il listener elabora l'evento. |
bytesTotal | Il numero di totale di byte che verranno scritti se il processo di scrittura avrà esito positivo. |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto FileStream che segnala il progresso. |
progress | Evento |
flash.events.ProgressEventproprietà ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Versioni runtime: | AIR 1.0 |
Segnala la disponibilità di nuovi dati nel flusso.
Definisce il valore della proprietàtype di un oggetto evento progress.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
bubbles | false |
bytesLoaded | Il numero di elementi o di byte caricati nel momento in cui il listener elabora l'evento. |
bytesTotal | Il numero totale di elementi o byte che vengono caricati se il processo di caricamento viene completato correttamente. |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto che riporta l'avanzamento. |
Tue Jun 12 2018, 02:44 PM Z