| Paket | flash.filesystem |
| Klass | public class FileStream |
| Arv | FileStream  EventDispatcher Object |
| Implementerar | IDataInput, IDataOutput |
| Körningsmiljöversioner: | AIR 1.0 |
open() anropas eller asynkront genom att metoden openAsync() anropas.
Fördelen med att öppna filer asynkront är att annan kod kan köras samtidigt som Adobe AIR kör läs- och skrivprocesser i bakgrunden. När filer öppnas asynkront skickas progress-händelser efterhand som åtgärderna utförs.
Ett File-objekt som öppnas synkront beter sig ungefär som ett ByteArray-objekt, och en fil som öppnas asynkront beter sig ungefär som ett Socket- eller URLStream-objekt. När ett File-objekt öppnas synkront pausar anroparen medan begärda data läses från eller skrivs till den underliggande filen. Om den öppnas asynkront buffras alla data som skrivs till strömmen direkt för att skrivas till filen senare.
Oavsett om en fil läses synkront eller asynkront så är själva läsmetoderna synkrona. I båda fallen läses data som är "tillgängliga" för tillfället. Skillnaden är att vid synkron läsning är alla data tillgängliga hela tiden, och vid asynkron läsning blir data tillgängliga efterhand som data strömmar till läsbufferten. Oavsett vilket, så representeras de data som kan läsas synkront i det aktuella ögonblicket av egenskapen bytesAvailable.
Ett program som bearbetar asynkrona indata registrerar sig vanligen för progress-händelser och använder data efterhand som dessa blir tillgängliga genom anrop av läsmetoder. Programmet kan också vänta tills alla data är tillgängliga genom att registrera sig för complete-händelsen och bearbeta hela datauppsättningen när complete-händelsen skickas.
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper| Egenskap | Definieras med | ||
|---|---|---|---|
| bytesAvailable : uint [skrivskyddad]
Returnerar antalet databyte som kan läsas i indatabufferten. | FileStream | ||
 | constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| endian : String
Byteordning för data, antingen konstanten BIG_ENDIAN eller LITTLE_ENDIAN från klassen Endian. | FileStream | ||
| objectEncoding : uint
Anger om AMF3- eller AMF0-formatet ska användas vid skrivning eller läsning av binära data med metoden readObject() eller writeObject(). | FileStream | ||
| position : Number
Den aktuella positionen i filen. | FileStream | ||
| readAhead : Number
Den minsta datamängd som ska läsas från disken när filer läses asynkront. | FileStream | ||
| Metod | Definieras med | ||
|---|---|---|---|
Skapar ett FileStream-objekt. | FileStream | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. | EventDispatcher | |
Stänger FileStream-objektet. | FileStream | ||
|
Skickar en händelse till händelseflödet. | EventDispatcher | |
|
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | |
|
Anger om det finns en egenskap angiven för ett objekt. | Object | |
|
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | |
Öppnar FileStream-objektet synkront och pekar på filen som anges av filparametern. | FileStream | ||
Öppnar FileStream-objektet asynkront och pekar på filen som anges av filparametern. | FileStream | ||
|
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | |
Läser ett booleskt värde från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Läser en signerad byte med tecken från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Läser så många databyte som anges av parametern length från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Läser ett IEEE 754-flyttal med dubbel precision från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Läser ett IEEE 754-flyttal med enkel precision från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Läser ett signerat 32-bitars heltal med tecken från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Skriver en multibyte-sträng med den angivna längden från filströmmen, byteströmmen eller bytearrayen med den angivna teckenuppsättningen. | FileStream | ||
Läser ett objekt till filflödet, byteflödet eller bytearrayen kodat i serialiserat AMF-format. | FileStream | ||
Läser ett signerat 16-bitars heltal med tecken från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Läser en osignerad byte med tecken från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Läser ett osignerat 32-bitars heltal med tecken från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Läser ett osignerat 16-bitars heltal med tecken från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Läser en UTF-8-sträng från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Läser en sekvens UTF-8-byte från byteflödet eller bytearrayen och returnerar en sträng. | FileStream | ||
|
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | |
|
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | |
|
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | |
|
Returnerar det angivna objektets strängbeteckning. | Object | |
Trunkerar filen vid den position som anges av egenskapen position i FileStream-objektet. | FileStream | ||
|
Returnerar det angivna objektets primitiva värde. | Object | |
|
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | EventDispatcher | |
Skriver ett booleskt värde. | FileStream | ||
Skriver en byte. | FileStream | ||
Skriver en sekvens av byte från den angivna bytearrayen, byte, med början på den byte som specificeras i offset (med ett nollbaserat index) med en längd specificerad i length, till filflödet, byteflödet eller bytearrayen. | FileStream | ||
Skriver ett IEEE 754-flyttal med dubbel precision (64 bitar). | FileStream | ||
Skriver ett IEEE 754-flyttal med enkel precision (32 bitar). | FileStream | ||
Skriver ett 32-bitars heltal med tecken. | FileStream | ||
Skriver en flerbytesträng till filflödet, byteflödet eller bytearrayen med den angivna teckenuppsättningen. | FileStream | ||
Skriver ett objekt till filflödet, byteflödet eller bytearrayen i serialiserat AMF-format. | FileStream | ||
Skriver ett 16-bitars heltal. | FileStream | ||
Skriver ett 32-bitars heltal utan tecken. | FileStream | ||
Skriver en UTF-8-sträng från filflödet, byteflödet eller bytearrayen. | FileStream | ||
Skriver en UTF-8-sträng. | FileStream | ||
| Händelse | Sammanfattning | Definieras med | ||
|---|---|---|---|---|
| [utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt. | EventDispatcher | ||
| Anger att strömmen har stängs av ett explicit anrop till close()-metoden. | FileStream | |||
| Anger att slutet av strömmen har nåtts. | FileStream | |||
| [utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | ||
| Anger att ett fel inträffade under den asynkrona in-/utdataåtgärden. | FileStream | |||
| Anger att buffrade data har skrivits till filen. | FileStream | |||
| Anger att det finns nya data i strömmen. | FileStream | |||
bytesAvailable | egenskap |
bytesAvailable:uint [skrivskyddad] | Körningsmiljöversioner: | AIR 1.0 |
Returnerar antalet databyte som kan läsas i indatabufferten. Användarens kod måste anropa bytesAvailable för att säkerställa att det finns tillräckligt mycket data innan det görs något läsförsök med andra läsmetoder.
Implementering
public function get bytesAvailable():uint endian | egenskap |
objectEncoding | egenskap |
objectEncoding:uint| Körningsmiljöversioner: | AIR 1.0 |
Anger om AMF3- eller AMF0-formatet ska användas vid skrivning eller läsning av binära data med metoden readObject() eller writeObject().
Det här värdet är en konstant från ObjectEncoding-klassen. AMF3-formatet används som standard.
Implementering
public function get objectEncoding():uint public function set objectEncoding(value:uint):voidRelaterade API-element
position | egenskap |
position:Number| Körningsmiljöversioner: | AIR 1.0 |
Den aktuella positionen i filen.
Det här värdet kan ändras på något av följande sätt:
- När du anger egenskapen explicit
- Vid läsning från FileStream-objektet (med någon av read-metoderna).
- Vid skrivning till FileStream-objektet
Positionen definieras som ett nummer (i stället för en enhet) för att ha stöd för filer som är större än 232 byte i längd. Värdet på den här egenskapen är alltid ett heltal som är mindre än 253. Om du anger det här värdet till ett tal med decimaler avrundas det nedåt till närmaste heltal.
När en fil läses asynkront, och du anger egenskapen position, börjar programmet att fylla läsbufferten med data från den angivna positionen, och egenskapen bytesAvailable kan anges till 0. Vänta på en complete-händelse innan du använder en read-metod för att läsa data, eller vänta på en progress-händelse och kontrollera egenskapen bytesAvailable innan du använder en read-metod.
Implementering
public function get position():Number public function set position(value:Number):voidExempel ( Så här använder du exemplet )
position-egenskap i FileStream-objektet uppdateras när programmet läser data från en fil.
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 | egenskap |
readAhead:Number| Körningsmiljöversioner: | AIR 1.0 |
Den minsta datamängd som ska läsas från disken när filer läses asynkront.
Den här egenskapen anger hur mycket data en asynkron ström försöker läsa förbi den aktuella positionen. Data läses i block baserat på filsystemets sidstorlek. Om du då anger readAhead som 9 000 på ett system med en sidstorlek på 8 kB (8 192 byte) läser miljön 2 block (eller 16 384 byte) framåt i taget. Standardvärdet för den här egenskapen är oändlighet: som standard läses en fil som har öppnats för asynkron läsning till slutet av filen.
Läsning av data från läsbufferten ändrar inte värdet för egenskapen readAhead. Efterhand som data läses från bufferten läses nya data in och fyller på läsbufferten.
Egenskapen readAhead påverkar inte filer som öppnas synkront.
När data läses in asynkront skickar FileStream-objektet progress-händelser. Kontrollera att det antal byte som behövs är tillgängliga i händelsehanterarmetoden för händelsen progress (genom att kontrollera egenskapen bytesAvailable) och läs sedan data från läsbufferten med en read-metod.
Implementering
public function get readAhead():Number public function set readAhead(value:Number):voidExempel ( Så här använder du exemplet )
readAhead för att begränsa mängden data som läses till en fil till 100 byte:
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 | () | Konstruktor |
public function FileStream()| Körningsmiljöversioner: | AIR 1.0 |
Skapar ett FileStream-objekt. Använd metoden open() eller openAsync() för att öppna en fil.
Relaterade API-element
close | () | metod |
public function close():void| Körningsmiljöversioner: | AIR 1.0 |
Stänger FileStream-objektet.
Du kan inte läsa eller skriva data efter att metoden close() har anropats. Om filen öppnades asynkront (FileStream-objektet använde openAsync() för att öppna filen), och metoden close() anropas, skickar objektet händelsen close.
Om du avslutar programmet stängs alla filer som är associerade med FileStream-objekt i programmet automatiskt. Det är emellertid bäst att registrera programmet för en closed-händelse för alla FileStream-objekt, som öppnas asynkront och har väntande data som ska skrivas, innan du avslutar programmet (för att försäkra dig om att dessa data verkligen skrivs).
Du kan återanvända FileStream-objektet genom att anropa metoden open() eller openAsync(). Då stängs alla filer som är associerade med FileStream-objektet utan att objektet skickar close-händelsen.
För ett FileStream-objekt som öppnas asynkront (med metoden openAsync()) gäller, att även om händelsen close() anropas för ett FileStream-objekt, och egenskaper och variabler som refererar till objektet tas bort, skräpsamlas inte FileStream-objektet så länge det finns väntande åtgärder och händelsehanterare har registrerats för att slutföra åtgärderna. Du bör särskilt tänka på att ett FileStream-objekt som i övrigt saknar referenser kommer att finnas kvar så länge något av följande är möjligt:
- För filläsningsåtgärder, så länge slutet inte har nåtts (och händelsen
completeinte har skickats). - Utdata är fortfarande tillgängliga för skrivning, och utdatarelaterade händelser (som händelsen
outputProgressellerioError) har registrerade händelseavlyssnare.
Händelser
close: — Filen, som öppnades asynkront, stängs.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
close() i FileStream-objektet stänger filen när data har skrivits.
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() i FileStream-objektet stänger filen när data har skrivits.
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 | () | metod |
public function open(file:File, fileMode:String):void| Körningsmiljöversioner: | AIR 1.0 |
Öppnar FileStream-objektet synkront och pekar på filen som har angetts av file-parametern.
Om FileStream-objektet redan är öppet kommer filen att stängas innan den öppnas på nytt, om metoden anropas och inga ytterligare händelser (inklusive close) ska skickas för den tidigare öppna filen.
På system med stöd för fillåsning är en fil som öppnas i ”skrivläge” eller ”uppdateringsläge” (FileMode.WRITE eller FileMode.UPDATE) inte läsbar förrän den stängs.
När du är klar med alla åtgärder för filen anropar du metoden close() för FileStream-objektet. På vissa operativsystem finns en gräns för hur många filer som kan vara öppna samtidigt.
Parametrar
file:File — Det File-objekt som anger vilken fil som ska öppnas.
| |
fileMode:String — En sträng från FileMode-klassen som definierar funktionerna i FileStream, t.ex. möjligheten att läsa från eller skriva till filen.
|
Utlöser
IOError — Filen finns inte, du har inte tillräcklig behörighet för att öppna filen, du öppnar en fil med läsåtkomst men saknar läsbehörighet eller du öppnar en fil med skrivåtkomst och saknar skrivbehörighet.
| |
SecurityError — Filplatsen är i programkatalogen, och parametern fileMode ställs in på läget ”append”, ”update” eller ”write”.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
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 | () | metod |
public function openAsync(file:File, fileMode:String):void| Körningsmiljöversioner: | AIR 1.0 |
Öppnar FileStream-objektet asynkront och pekar på filen som anges av file-parametern.
Om FileStream-objektet redan är öppet kommer filen att stängas innan den öppnas på nytt, om metoden anropas och inga ytterligare händelser (inklusive close) ska skickas för den tidigare öppna filen.
Om parametern fileMode anges som FileMode.READ eller FileMode.UPDATE läser AIR data till indatabufferten så fort filen öppnas, och progress- och open-händelser skickas efterhand som data läses till indatabufferten.
På system med stöd för fillåsning är en fil som öppnas i ”skrivläge” eller ”uppdateringsläge” (FileMode.WRITE eller FileMode.UPDATE) inte läsbar förrän den stängs.
När du är klar med alla åtgärder för filen anropar du metoden close() för FileStream-objektet. På vissa operativsystem finns en gräns för hur många filer som kan vara öppna samtidigt.
Parametrar
file:File — Det File-objekt som anger vilken fil som ska öppnas.
| |
fileMode:String — En sträng från FileMode-klassen som definierar funktionerna i FileStream, t.ex. möjligheten att läsa från eller skriva till filen.
|
Händelser
ioError: — Filen finns inte, du har inte tillräcklig behörighet för att öppna filen, du öppnar en fil med läsåtkomst men saknar läsbehörighet eller du öppnar en fil med skrivåtkomst och saknar skrivbehörighet.
| |
progress: — Skickas efterhand som data läses till indatabufferten. (Filen måste öppnas med fileMode-parametern inställd på FileMode.READ eller FileMode.UPDATE.)
| |
complete: — Filens data har lästs till indatabufferten. (Filen måste öppnas med fileMode-parametern inställd på FileMode.READ eller FileMode.UPDATE.)
|
Utlöser
SecurityError — Filplatsen är i programkatalogen, och parametern fileMode ställs in på läget ”append”, ”update” eller ”write”.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
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 | () | metod |
public function readBoolean():Boolean| Körningsmiljöversioner: | AIR 1.0 |
Läser ett booleskt värde från filflödet, byteflödet eller bytearrayen. En enkel byte läses och true returneras om bytevärdet inte är noll, i annat fall false.
Boolean — Ett booleskt värde true om bytevärdet inte är noll, i annat fall false.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readByte | () | metod |
public function readByte():int| Körningsmiljöversioner: | AIR 1.0 |
Läser en signerad byte med tecken från filflödet, byteflödet eller bytearrayen.
Returnerarint — Det returnerade värdet är i intervallet -128 till 127.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readBytes | () | metod |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| Körningsmiljöversioner: | AIR 1.0 |
Läser så många databyte som anges av parametern length från filflödet, byteflödet eller bytearrayen. Bytena läses till det ByteArray-objekt som anges av parametern bytes med start vid den position som anges av offset.
Parametrar
bytes:ByteArray — ByteArray-objektet som data ska läsas till.
| |
offset:uint (default = 0)bytes där dataläsningen ska börja.
| |
length:uint (default = 0) |
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readDouble | () | metod |
public function readDouble():Number| Körningsmiljöversioner: | AIR 1.0 |
Läser ett IEEE 754-flyttal med dubbel precision från filflödet, byteflödet eller bytearrayen.
ReturnerarNumber — Ett IEEE 754-flyttal med dubbel precision.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readFloat | () | metod |
public function readFloat():Number| Körningsmiljöversioner: | AIR 1.0 |
Läser ett IEEE 754-flyttal med enkel precision från filflödet, byteflödet eller bytearrayen.
ReturnerarNumber — Ett IEEE 754-flyttal med enkel precision.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readInt | () | metod |
public function readInt():int| Körningsmiljöversioner: | AIR 1.0 |
Läser ett signerat 32-bitars heltal med tecken från filflödet, byteflödet eller bytearrayen.
Returnerarint — Det returnerade värdet är i intervallet -2147483648 till 2147483647.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readMultiByte | () | metod |
public function readMultiByte(length:uint, charSet:String):String| Körningsmiljöversioner: | AIR 1.0 |
Skriver en multibyte-sträng med den angivna längden från filströmmen, byteströmmen eller bytearrayen med den angivna teckenuppsättningen.
Parametrar
length:uint — Antalet byte från byteflödet som ska läsas.
| |
charSet:String — Strängen som anger teckenuppsättningen som ska användas för att tolka byte. Möjliga teckenuppsättningsträngar är "shift-jis", "cn-gb", "iso-8859-1" med flera. En fullständig lista finns i Teckenuppsättningar som stöds.
Obs! Om värdet för parametern |
String — UTF-8-kodad sträng.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
Relaterade API-element
readObject | () | metod |
public function readObject():*| Körningsmiljöversioner: | AIR 1.0 |
Läser ett objekt till filflödet, byteflödet eller bytearrayen kodat i serialiserat AMF-format.
Returnerar* — Det avserialiserade objektet.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
Relaterade API-element
readShort | () | metod |
public function readShort():int| Körningsmiljöversioner: | AIR 1.0 |
Läser ett signerat 16-bitars heltal med tecken från filflödet, byteflödet eller bytearrayen.
Returnerarint — Det returnerade värdet är i intervallet -32768 till 32767.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readUnsignedByte | () | metod |
public function readUnsignedByte():uint| Körningsmiljöversioner: | AIR 1.0 |
Läser en osignerad byte med tecken från filflödet, byteflödet eller bytearrayen.
Returneraruint — Det returnerade värdet är i intervallet 0 till 255.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readUnsignedInt | () | metod |
public function readUnsignedInt():uint| Körningsmiljöversioner: | AIR 1.0 |
Läser ett osignerat 32-bitars heltal med tecken från filflödet, byteflödet eller bytearrayen.
Returneraruint — Det returnerade värdet är i intervallet 0 till 4294967295.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readUnsignedShort | () | metod |
public function readUnsignedShort():uint| Körningsmiljöversioner: | AIR 1.0 |
Läser ett osignerat 16-bitars heltal med tecken från filflödet, byteflödet eller bytearrayen.
Returneraruint — Det returnerade värdet är i intervallet 0 till 65535.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readUTF | () | metod |
public function readUTF():String| Körningsmiljöversioner: | AIR 1.0 |
Läser en UTF-8-sträng från filflödet, byteflödet eller bytearrayen. Strängen antas inledas av typen short utan tecken som visar längden i byte.
Den här metoden liknar metoden readUTF() i Java® IDataInput-gränssnittet.
String — En UTF-8-sträng som skapats av byteåtergivningen av tecken.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
readUTFBytes | () | metod |
public function readUTFBytes(length:uint):String| Körningsmiljöversioner: | AIR 1.0 |
Läser en sekvens UTF-8-byte från byteflödet eller bytearrayen och returnerar en sträng.
Parametrar
length:uint — Antalet byte som ska läsas.
|
String — En UTF-8-sträng som har skapats av byteåtergivningen av tecken av angiven längd.
|
Händelser
ioError: — Det går inte att läsa filen, eller filen är inte öppen. Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan läsfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte läsas (t.ex. på grund av att filen saknas).
| |
EOFError — Den position som anges för läsning av data överskrider det tillgängliga antalet byte (som anges av egenskapen bytesAvailable).
|
truncate | () | metod |
public function truncate():void| Körningsmiljöversioner: | AIR 1.0 |
Trunkerar filen vid den position som anges av egenskapen position i FileStream-objektet.
Byte från den position som anges av egenskapen position till slutet av filen tas bort. Filen måste vara öppen för skrivning.
Utlöser
IllegalOperationError — Filen är inte öppen för skrivning.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
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 | () | metod |
public function writeBoolean(value:Boolean):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver ett booleskt värde. En enkel byte skrivs i enlighet med parametern value, antingen 1 om värdet är true eller 0 om värdet är false.
Parametrar
value:Boolean — Ett booleskt värde, som fastställer vilken byte som skrivs. Om parametern är true skrivs 1. Om den är false skrivs 0.
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
writeByte | () | metod |
public function writeByte(value:int):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver en byte. De första 8 bitarna i parametern används, de övre 24 bitarna ignoreras.
Parametrar
value:int — Ett bytevärde som heltal.
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
writeBytes | () | metod |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver en bytesekvens från den angivna bytearrayen, bytes, med början på den byte som anges av offset (med ett nollbaserat index) och med den längd som anges av length, till filströmmen, byteströmmen eller bytearrayen.
Om parametern length utelämnas används standardlängden 0 och hela bufferten med början på offset skrivs. Om parametern offset också utelämnas skrivs hela bufferten.
Om parametern offset eller parameternlength är utanför intervallet kläms de ihop i början och slutet av bytes-arrayen
Parametrar
bytes:ByteArray — Den bytearray som ska skrivas.
| |
offset:uint (default = 0) | |
length:uint (default = 0) |
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
writeDouble | () | metod |
public function writeDouble(value:Number):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver ett IEEE 754-flyttal med dubbel precision (64 bitar).
Parametrar
value:Number — Ett flyttal med dubbel precision (64 bitar).
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
writeFloat | () | metod |
public function writeFloat(value:Number):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver ett IEEE 754-flyttal med enkel precision (32 bitar).
Parametrar
value:Number — Ett flyttal med enkel precision (32 bitar).
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
writeInt | () | metod |
public function writeInt(value:int):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver ett 32-bitars heltal med tecken.
Parametrar
value:int — Ett bytevärde som heltal med tecken.
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
writeMultiByte | () | metod |
public function writeMultiByte(value:String, charSet:String):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver en flerbytesträng till filflödet, byteflödet eller bytearrayen med den angivna teckenuppsättningen.
Parametrar
value:String — Det strängvärde som ska skrivas.
| |
charSet:String — Strängen som anger den teckenuppsättning som ska användas. Möjliga teckenuppsättningsträngar är "shift-jis", "cn-gb", "iso-8859-1" med flera. En fullständig lista finns i Teckenuppsättningar som stöds.
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
Relaterade API-element
writeObject | () | metod |
public function writeObject(object:*):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver ett objekt till filflödet, byteflödet eller bytearrayen i serialiserat AMF-format.
Parametrar
object:* — Objektet som ska serialiseras.
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
Relaterade API-element
writeShort | () | metod |
public function writeShort(value:int):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver ett 16-bitars heltal. De första 16 bitarna i parametern används, de övre 16 bitarna ignoreras.
Parametrar
value:int — Ett bytevärde som heltal.
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
writeUnsignedInt | () | metod |
public function writeUnsignedInt(value:uint):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver ett 32-bitars heltal utan tecken.
Parametrar
value:uint — Ett bytevärde som heltal utan tecken.
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
writeUTF | () | metod |
public function writeUTF(value:String):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver en UTF-8-sträng från filflödet, byteflödet eller bytearrayen. Först skrivs längden på en UTF-8-sträng i byte, som ett 16-bitars heltal, följt av de byte som representerar strängens tecken.
Parametrar
value:String — Det strängvärde som ska skrivas.
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
RangeError — Om strängens längd överstiger 65535.
| |
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
writeUTFBytes | () | metod |
public function writeUTFBytes(value:String):void| Körningsmiljöversioner: | AIR 1.0 |
Skriver en UTF-8-sträng. Liknar writeUTF() men använder inte ett ord på 16-bitar som prefix i strängen.
Parametrar
value:String — Det strängvärde som ska skrivas.
|
Händelser
ioError: — Det går inte att skriva till filen (till exempel på grund av att den saknas). Den här händelsen skickas bara för filer som har öppnats för asynkrona åtgärder (med metoden openAsync()).
|
Utlöser
IOError — Filen har inte öppnats; filen har öppnats men den öppnades utan skrivfunktioner eller, om det är en fil som har öppnats för synkrona åtgärder (med metoden open()), så kan filen inte skrivas till (t.ex. på grund av att filen saknas).
|
close | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.CLOSE| Körningsmiljöversioner: | AIR 1.0 |
Anger att strömmen har stängs av ett explicit anrop till close()-metoden.
Event.CLOSE-konstanten definierar värdet på type-egenskapen i ett close-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Det objekt vars anslutning har stängts. |
Relaterade API-element
complete | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.COMPLETE| Körningsmiljöversioner: | AIR 1.0 |
Anger att slutet av strömmen har nåtts.
Event.COMPLETE-konstanten definierar värdet på type-egenskapen i ett complete-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Det nätverksobjekt som har lästs in. |
Relaterade API-element
ioError | Händelse |
flash.events.IOErrorEventegenskap IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Körningsmiljöversioner: | AIR 1.0 |
Anger att ett fel inträffade under den asynkrona in-/utdataåtgärden.
Definierar värdet för ettioError-händelseobjekts type-egenskap.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
errorID | Ett referensnummer som associeras med det specifika felet (enbart AIR). |
target | Objektet är med om ett in-/utdatafel. |
text | Text som visas som felmeddelande. |
outputProgress | Händelse |
flash.events.OutputProgressEventegenskap OutputProgressEvent.type =
flash.events.OutputProgressEvent.OUTPUT_PROGRESS| Körningsmiljöversioner: | AIR 1.0 |
Anger att buffrade data har skrivits till filen.
Definierar värdet påtype-egenskapen i ett outputProgress-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
bytesPending | Antalet byte som har lästs in när avlyssnaren bearbetar händelsen. |
bytesTotal | Totalt antal byte som kommer att skrivas om skrivprocessen slutförs. |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | FileStream-objektet rapporterar förlopp. |
progress | Händelse |
flash.events.ProgressEventegenskap ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Körningsmiljöversioner: | AIR 1.0 |
Anger att det finns nya data i strömmen.
Definierar värdet för ettprogress-händelseobjekts type-egenskap.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
bytesLoaded | Antalet objekt eller byte som har lästs in när avlyssnaren bearbetar händelsen. |
bytesTotal | Det totala antalet objekt eller byte som kommer att ha lästs in om inläsningen lyckas. |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Objektet rapporterar förlopp. |
Tue Jun 12 2018, 01:40 PM Z