Pakket | flash.filesystem |
Klasse | public class FileStream |
Overerving | FileStream EventDispatcher Object |
Implementatie | IDataInput, IDataOutput |
Runtimeversies: | AIR 1.0 |
open()
aan te roepen of asynchroon door de methode openAsync()
aan te roepen.
Het voordeel van het asynchroon openen van bestanden is dat andere code kan worden uitgevoerd terwijl Adobe AIR in de achtergrond lees- en schrijfprocessen uitvoert. Bij asynchroon openen worden progress
-gebeurtenissen verzonden tijdens de voortgang van de verschillende bewerkingen.
Een File-object dat synchroon wordt geopend, gedraagt zich als een ByteArray-object; een bestand dat asynchroon wordt geopend, gedraagt zich als een Socket- of URLStream-object. Wanneer een File-object synchroon wordt geopend, wordt de aanroeper onderbroken terwijl de gevraagde gegevens in of naar het onderliggende bestand worden gelezen of geschreven. Bij asynchroon openen worden alle gegevens die naar de stroom worden geschreven, direct gebufferd en later naar het bestand geschreven.
Bij synchroon én asynchroon lezen in een bestand verlopen de daadwerkelijke leesmethoden synchroon. In beide gevallen worden gegevens gelezen die momenteel "beschikbaar" zijn. Het verschil is dat bij synchroon lezen alle gegevens altijd beschikbaar zijn, en bij asynchroon lezen gegevens geleidelijk beschikbaar komen terwijl deze in een leesbuffer stromen. In beide gevallen worden de gegevens die op dat moment synchroon kunnen worden gelezen, worden aangeduid met de eigenschap bytesAvailable
.
Een toepassing die asynchrone invoer verwerkt, registreert normaal gesproken voor progress
-gebeurtenissen en verbruikt de gegevens wanneer deze beschikbaar komen door leesmethoden aan te roepen. Een toepassing kan ook gewoon wachten totdat alle gegevens beschikbaar zijn door te registreren voor de gebeurtenis complete
de complete gegevensset te verwerken wanneer de gebeurtenis complete
is verzonden.
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
bytesAvailable : uint [alleen-lezen]
Hiermee wordt het aantal beschikbare gegevensbytes voor het lezen in de invoerbuffer geretourneerd. | FileStream | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
endian : String
De bytevolgorde voor de gegevens, de constante BIG_ENDIAN of LITTLE_ENDIAN uit de klasse Endian. | FileStream | ||
objectEncoding : uint
Bepaalt of de indeling AMF3 of AMF0 wordt gebruikt bij het lezen of schrijven van binaire gegevens met de methode readObject() of writeObject(). | FileStream | ||
position : Number
De huidige positie in het bestand. | FileStream | ||
readAhead : Number
De minimale hoeveelheid gegevens die van de schijf kan worden gelezen bij het asynchroon lezen van bestanden. | FileStream |
Methode | Gedefinieerd door | ||
---|---|---|---|
Maakt een object van het type FileStream. | FileStream | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | ||
Sluit het FileStream-object. | FileStream | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Opent het FileStream-object synchroon, waarbij het bestand wordt aangewezen dat met de parameter file is opgegeven. | FileStream | ||
Opent het FileStream-object asynchroon, waarbij het bestand wordt aangewezen dat met de parameter file is opgegeven. | FileStream | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Leest een Booleaanse waarde uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een byte met teken uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest het aantal gegevensbytes dat met de parameter length is opgegeven, uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een IEEE 754 drijvende-kommagetal met dubbele precisie uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een IEEE 754 drijvende-kommagetal met enkele precisie uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een 32-bits geheel getal met teken uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een multibyte-tekenreeks van de opgegeven lengte met de opgegeven tekenset uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een object dat in AMF-indeling met serienummering is gecodeerd, uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een 16-bits geheel getal met teken uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een byte zonder teken uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een 32-bits geheel zonder teken uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een 16-bits geheel zonder teken uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een UTF-8-tekenreeks uit de bestandsstream, bytestream of bytearray. | FileStream | ||
Leest een reeks van UTF-8-bytes uit de bytestream of bytearray en retourneert een tekenreeks. | FileStream | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Kort het bestand in op de positie die is aangegeven door de eigenschap position van het FileStream-object. | FileStream | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher | ||
Schrijft een booleaanse waarde. | FileStream | ||
Schrijft een byte. | FileStream | ||
Schrijft een reeks van bytes vanuit de opgegeven bytearray bytes, te beginnen op de byte die is opgegeven met offset (met een op nul gebaseerde indexwaarde) met een lengte die is opgegeven met length, naar de bestandsstream, bytestream of bytearray. | FileStream | ||
Schrijft een IEEE 754 drijvende-kommagetal (64-bits) met dubbele precisie. | FileStream | ||
Schrijft een IEEE 754 drijvende-kommagetal (32-bits) met enkele precisie. | FileStream | ||
Schrijft een 32-bits geheel getal met teken. | FileStream | ||
Schrijft een multibyte-tekenreeks naar de bestandsstream, bytestream of byte-array met de opgegeven tekenset. | FileStream | ||
Schrijft een object dat in AMF-indeling met serienummering is gecodeerd, naar de bestandsstream, bytestream of bytearray. | FileStream | ||
Schrijft een 16-bits geheel getal. | FileStream | ||
Schrijft een 32-bits geheel getal zonder teken. | FileStream | ||
Schrijft een UTF-8-tekenreeks naar de bestandsstream, bytestream of byte-array. | FileStream | ||
Schrijft een UTF-8-tekenreeks. | FileStream |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | |||
Geeft aan dat de stroom is gesloten door een expliciete aanroep van de methode close(). | FileStream | |||
Geeft aan dat het einde van de stroom is bereikt. | FileStream | |||
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | |||
Geeft aan dat er een fout is opgetreden tijdens een asynchrone I/O-bewerking van het bestand. | FileStream | |||
Geeft aan dat de gebufferde gegevens naar het bestand zijn geschreven. | FileStream | |||
Geeft aan dat er nieuwe gegevens beschikbaar zijn in de stroom. | FileStream |
bytesAvailable | eigenschap |
bytesAvailable:uint
[alleen-lezen] Runtimeversies: | AIR 1.0 |
Hiermee wordt het aantal beschikbare gegevensbytes voor het lezen in de invoerbuffer geretourneerd. Gebruikerscode moet bytesAvailable
aanroepen om er zeker van te zijn dat voldoende gegevens beschikbaar zijn voordat wordt geprobeerd deze te lezen met een van de methoden read.
Implementatie
public function get bytesAvailable():uint
endian | eigenschap |
objectEncoding | eigenschap |
objectEncoding:uint
Runtimeversies: | AIR 1.0 |
Bepaalt of de indeling AMF3 of AMF0 wordt gebruikt bij het lezen of schrijven van binaire gegevens met de methode readObject()
of writeObject()
.
De waarde is een constante van de klasse ObjectEncoding. Standaard wordt de indeling AMF3 gebruikt.
Implementatie
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
Verwante API-elementen
position | eigenschap |
position:Number
Runtimeversies: | AIR 1.0 |
De huidige positie in het bestand.
De waarde wordt op een van de volgende manieren gewijzigd:
- wanneer u de eigenschap expliciet instelt
- Wanneer wordt gelezen van het FileStream-object (met een van de leesmethoden)
- wanneer wordt geschreven naar het FileStream-object
De positie is gedefinieerd als een getal (in plaats van een eenheid) om bestanden te ondersteunen die langer zijn dan 232 bytes. De waarde van deze eigenschap is altijd een geheel getal kleiner dan 253. Als u deze waarde op een getal met een breuk instelt, wordt de waarde naar beneden afgerond naar het dichtstbijzijnde gehele getal.
Als u bij het asynchroon lezen van een bestand de eigenschap position
instelt, begint de toepassing de leesbuffer te vullen met gegevens, vanaf de opgegeven positie, en kan de eigenschap bytesAvailable
op 0 worden gezet. Wacht op een gebeurtenis complete
voordat u een leesmethode gebruikt om gegevens te lezen; of wacht op een gebeurtenis progress
en controleer de eigenschap bytesAvailable
voordat u een leesmethode gebruikt.
Implementatie
public function get position():Number
public function set position(value:Number):void
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
position
van het FileStream-object wordt bijgewerkt terwijl de toepassing gegevens van een bestand leest.
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 | eigenschap |
readAhead:Number
Runtimeversies: | AIR 1.0 |
De minimale hoeveelheid gegevens die van de schijf kan worden gelezen bij het asynchroon lezen van bestanden.
Deze eigenschap bepaalt hoeveel gegevens een asynchrone stroom probeert te lezen na de huidige positie. De gegevens worden in blokken gelezen, op basis van het paginaformaat van het bestandssysteem. Als u readAhead
bijvoorbeeld instelt op 9000 op een computersysteem met een paginaformaat van 8 kB (8192 byte), leest de runtime 2 blokken vooruit (of 16.384 bytes tegelijkertijd). De standaardwaarde van deze eigenschap is oneindig: standaard wordt een bestand dat is geopend om asynchroon te worden gelezen, gelezen tot aan het einde van het bestand.
Gegevens in de leesbuffer lezen verandert de waarde van de eigenschap readAhead
niet. Wanneer u gegevens uit de buffer leest, worden nieuwe gegevens gelezen om de leesbuffer opnieuw te vullen.
De eigenschap readAhead
heeft geen invloed op een bestand dat synchroon is geopend.
Bij het asynchroon lezen van gegevens verzendt het FileStream-object progress
-gebeurtenissen. In de gebeurtenishandlermethode voor de gebeurtenis progress
controleert u of het vereiste aantal bytes beschikbaar is (door de eigenschap bytesAvailable
te controleren) en leest u daarna de gegevens uit de leesbuffer met een leesmethode.
Implementatie
public function get readAhead():Number
public function set readAhead(value:Number):void
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
readAhead
gebruikt om de hoeveelheid gegevens die in een bestand wordt gelezen tot 100 bytes:
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 | () | Constructor |
public function FileStream()
Runtimeversies: | AIR 1.0 |
Maakt een object van het type FileStream. Gebruik de methode open()
of openAsync()
om een bestand te openen.
Verwante API-elementen
close | () | methode |
public function close():void
Runtimeversies: | AIR 1.0 |
Sluit het FileStream-object.
Nadat u de methode close()
hebt aangeroepen, kunt u geen gegevens meer lezen of schrijven. Als het bestand asynchroon is geopend (het FileStream-object heeft de methode openAsync()
gebruikt om het bestand te openen), verzendt het object met het aanroepen van de methode close()
de gebeurtenis close
.
Als de toepassing automatisch wordt gesloten, worden alle bestanden gesloten die in de toepassing aan FileStream-objecten zijn gekoppeld. Het is echter het beste om te registreren voor de gebeurtenis closed
op alle FileStream-objecten die asynchroon zijn geopend waarvoor nog gegevens klaar staan om te worden geschreven, voordat u de toepassing sluit (om er zeker van te zijn dat de gegevens worden geschreven).
U kunt het FileStream-object nogmaals gebruiken door de methode open()
of openAsync()
aan te roepen. Hierdoor worden alle bestanden gesloten die aan het FileStream-object zijn gekoppeld, maar het object verzendt de gebeurtenis close
niet.
Voor een FileStream-object dat asynchroon is geopend (met de methode openAsync()
) geldt dat, zelfs als u de gebeurtenis close()
aanroept voor een FileStream-object en eigenschappen en variabelen verwijdert die naar het object verwijzen, het FileStream-object niet wordt opgeschoond zolang er bewerkingen in behandeling zijn en er gebeurtenishandlers zijn geregistreerd voor de voltooiing. Een FileStream-object waarnaar verder niet wordt verwezen, zal dan aanwezig blijven zolang een van de volgende mogelijkheden nog bestaan:
- Bij het lezen van bestanden is het einde van het bestand nog niet bereikt (en de gebeurtenis
complete
is niet verzonden). - Er zijn nog uitvoergegevens beschikbaar die moeten worden geschreven en aan uitvoer gerelateerde gebeurtenissen (zoals de gebeurtenis
outputProgress
ofioError
) hebben gebeurtenislisteners geregistreerd.
Gebeurtenissen
close: — Het bestand, dat asynchroon is geopend, wordt gesloten.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
close()
van het FileStream-object sluit het bestand wanneer de gegevens zijn geschreven.
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()
van het FileStream-object sluit het bestand wanneer de gegevens zijn geschreven.
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 | () | methode |
public function open(file:File, fileMode:String):void
Runtimeversies: | AIR 1.0 |
Opent het FileStream-object synchroon, waarbij het bestand wordt aangewezen dat met de parameter file
is opgegeven.
Als het FileStream-object al geopend is, wordt het bestand eerst gesloten voordat het wordt geopend en worden geen andere gebeurtenissen (inclusief close
) verzonden voor het eerder geopende bestand.
Op systemen waarop bestandsblokkering wordt ondersteund, is een bestand dat in de modus "schrijven" of "bijwerken" is geopend (FileMode.WRITE
of FileMode.UPDATE
), pas leesbaar wanneer het gesloten is.
Wanneer u klaar bent met het uitvoeren van bewerkingen op het bestand, roept u de close()
-methode van het FileStream-object op. Sommige besturingssystemen beperken het aantal bestanden die tegelijkertijd geopend kunnen worden.
Parameters
file:File — Het object File dat aangeeft welk bestand moet worden geopend.
| |
fileMode:String — Een tekenreeks uit de klasse FileMode die de mogelijkheden van de FileStream definieert, zoals de mogelijkheid om van of naar het bestand te lezen of te schrijven.
|
Gegenereerde uitzondering
IOError — Het bestand bestaat niet; u hebt niet de juiste bevoegdheden om het bestand te openen; u opent een bestand omdat u leestoegang wilt maar u hebt niet de juiste bevoegdheden hiervoor of u opent een bestand omdat u ernaar wilt schrijven maar u hebt hiervoor niet de juiste bevoegdheden.
| |
SecurityError — De bestandslocatie is de toepassingsmap en de parameter fileMode is ingesteld op de modus "append", "update" of "write".
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
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 | () | methode |
public function openAsync(file:File, fileMode:String):void
Runtimeversies: | AIR 1.0 |
Opent het FileStream-object asynchroon, waarbij het bestand wordt aangewezen dat met de parameter file
is opgegeven.
Als het FileStream-object al geopend is, wordt het bestand eerst gesloten voordat het wordt geopend en worden geen andere gebeurtenissen (inclusief close
) verzonden voor het eerder geopende bestand.
Als de fileMode
-parameter is ingesteld op FileMode.READ
of FileMode.UPDATE
, leest AIR gegevens in de invoerbuffer zodra het bestand wordt geopend en worden de gebeurtenissen progress
en open
verzonden terwijl de gegevens in de invoerbuffer worden gelezen.
Op systemen waarop bestandsblokkering wordt ondersteund, is een bestand dat in de modus "schrijven" of "bijwerken" is geopend (FileMode.WRITE
of FileMode.UPDATE
), pas leesbaar wanneer het gesloten is.
Wanneer u klaar bent met het uitvoeren van bewerkingen op het bestand, roept u de close()
-methode van het FileStream-object op. Sommige besturingssystemen beperken het aantal bestanden die tegelijkertijd geopend kunnen worden.
Parameters
file:File — Het object File dat aangeeft welk bestand moet worden geopend.
| |
fileMode:String — Een tekenreeks uit de klasse FileMode die de mogelijkheden van de FileStream definieert, zoals de mogelijkheid om van of naar het bestand te lezen of te schrijven.
|
Gebeurtenissen
ioError: — Het bestand bestaat niet; u hebt niet de juiste bevoegdheden om het bestand te openen; u opent een bestand omdat u leestoegang wilt maar u hebt niet de juiste bevoegdheden hiervoor of u opent een bestand omdat u ernaar wilt schrijven maar u hebt hiervoor niet de juiste bevoegdheden.
| |
progress: — Wordt verzonden terwijl gegevens in de invoerbuffer worden gelezen. (Het bestand moet zijn geopend met de fileMode -parameter ingesteld op FileMode.READ of FileMode.UPDATE .)
| |
complete: — De bestandsgegevens zijn in de invoerbuffer gelezen. (Het bestand moet zijn geopend met de fileMode -parameter ingesteld op FileMode.READ of FileMode.UPDATE .)
|
Gegenereerde uitzondering
SecurityError — De bestandslocatie is de toepassingsmap en de parameter fileMode is ingesteld op de modus "append", "update" of "write".
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
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 | () | methode |
public function readBoolean():Boolean
Runtimeversies: | AIR 1.0 |
Leest een booleaanse waarde uit de bestandsstream, bytestream of bytearray. Er wordt één byte gelezen en true
wordt geretourneerd wanneer de byte niet gelijk is aan 0. Anders wordt false
geretourneerd.
Boolean — Een Booleaanse waarde die true is wanneer de byte niet-nul is, anders false .
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readByte | () | methode |
public function readByte():int
Runtimeversies: | AIR 1.0 |
Leest een byte met teken uit de bestandsstream, bytestream of bytearray.
Geretourneerde waardeint — De geretourneerde waarde ligt in het bereik -128 t/m 127.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readBytes | () | methode |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Runtimeversies: | AIR 1.0 |
Leest het aantal gegevensbytes dat met de parameter length
is opgegeven, uit de bestandsstream, bytestream of bytearray. De bytes worden ingelezen in het object ByteArray, dat is opgegeven door de parameter bytes
, te beginnen bij de positie die is opgegeven door offset
.
Parameters
bytes:ByteArray — Het object ByteArray waarin gegevens worden ingelezen.
| |
offset:uint (default = 0 ) — De verschuiving naar de parameter bytes waar begonnen moet worden met het lezen van gegevens.
| |
length:uint (default = 0 ) — Het aantal bytes dat moet worden gelezen. De standaardwaarde 0 zorgt ervoor dat alle beschikbare gegevens worden gelezen.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readDouble | () | methode |
public function readDouble():Number
Runtimeversies: | AIR 1.0 |
Leest een IEEE 754 drijvende-kommagetal met dubbele precisie uit de bestandsstream, bytestream of bytearray.
Geretourneerde waardeNumber — Een IEEE 754 drijvende-kommagetal met dubbele precisie.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readFloat | () | methode |
public function readFloat():Number
Runtimeversies: | AIR 1.0 |
Leest een IEEE 754 drijvende-kommagetal met enkele precisie uit de bestandsstream, bytestream of bytearray.
Geretourneerde waardeNumber — Een IEEE 754 drijvende-kommagetal met enkele precisie.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readInt | () | methode |
public function readInt():int
Runtimeversies: | AIR 1.0 |
Leest een 32-bits geheel getal met teken uit de bestandsstream, bytestream of bytearray.
Geretourneerde waardeint — De geretourneerde waarde ligt in het bereik -2147483648 t/m 2147483647.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readMultiByte | () | methode |
public function readMultiByte(length:uint, charSet:String):String
Runtimeversies: | AIR 1.0 |
Leest een multibyte-tekenreeks van de opgegeven lengte met de opgegeven tekenset uit de bestandsstream, bytestream of bytearray.
Parameters
length:uint — Het aantal bytes van de bytestream dat moet worden gelezen.
| |
charSet:String — De tekenreeks die de tekenset aangeeft die moet worden gebruikt om de bytes te interpreteren. Mogelijke tekensetreeksen zijn onder andere shift-jis , cn-gb , iso-8859-1 en andere. Zie Ondersteunde tekensets voor een complete lijst.
Opmerking: wanneer de waarde voor de parameter |
String — Een UTF-8-gecodeerde tekenreeks.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
Verwante API-elementen
readObject | () | methode |
public function readObject():*
Runtimeversies: | AIR 1.0 |
Leest een object dat in AMF-indeling met serienummering is gecodeerd, uit de bestandsstream, bytestream of bytearray.
Geretourneerde waarde* — Het gedeserialiseerde object.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
Verwante API-elementen
readShort | () | methode |
public function readShort():int
Runtimeversies: | AIR 1.0 |
Leest een 16-bits geheel getal met teken uit de bestandsstream, bytestream of bytearray.
Geretourneerde waardeint — De geretourneerde waarde ligt in het bereik -32768 t/m 32767.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readUnsignedByte | () | methode |
public function readUnsignedByte():uint
Runtimeversies: | AIR 1.0 |
Leest een byte zonder teken uit de bestandsstream, bytestream of bytearray.
Geretourneerde waardeuint — De geretourneerde waarde ligt in het bereik 0 t/m 255.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readUnsignedInt | () | methode |
public function readUnsignedInt():uint
Runtimeversies: | AIR 1.0 |
Leest een 32-bits geheel zonder teken uit de bestandsstream, bytestream of bytearray.
Geretourneerde waardeuint — De geretourneerde waarde ligt in het bereik 0 t/m 4294967295.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readUnsignedShort | () | methode |
public function readUnsignedShort():uint
Runtimeversies: | AIR 1.0 |
Leest een 16-bits geheel zonder teken uit de bestandsstream, bytestream of bytearray.
Geretourneerde waardeuint — De geretourneerde waarde ligt in het bereik 0 t/m 65535.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readUTF | () | methode |
public function readUTF():String
Runtimeversies: | AIR 1.0 |
Leest een UTF-8-tekenreeks uit de bestandsstream, bytestream of bytearray. Er wordt aangenomen dat de tekenreeks begint met een kort geheel getal zonder teken dat de lengte in bytes aangeeft.
Deze methode is vergelijkbaar met de methode readUTF()
in de Java®-interface IDataInput.
String — Een UTF-8-tekenreeks die is geproduceerd door de byterepresentatie van tekens.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
readUTFBytes | () | methode |
public function readUTFBytes(length:uint):String
Runtimeversies: | AIR 1.0 |
Leest een reeks van UTF-8-bytes uit de bytestream of bytearray en retourneert een tekenreeks.
Parameters
length:uint — Het aantal bytes dat moet worden gelezen.
|
String — Een UTF-8-tekenreeks die is geproduceerd door de byterepresentatie van tekens met de opgegeven lengte.
|
Gebeurtenissen
ioError: — Het bestand kan niet worden gelezen of het bestand is niet geopend. Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met leesmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden gelezen (omdat het bijvoorbeeld niet aanwezig is).
| |
EOFError — De positie die voor het lezen van gegevens is opgegeven, is groter dan het aantal beschikbare bytes (aangeduid door de eigenschap bytesAvailable ).
|
truncate | () | methode |
public function truncate():void
Runtimeversies: | AIR 1.0 |
Kort het bestand in op de positie die is aangegeven door de eigenschap position
van het FileStream-object.
Bytes worden verwijderd vanaf de positie die is aangegeven door de eigenschap position
tot het einde van het bestand. Het bestand moet geopend zijn voor schrijven.
Gegenereerde uitzondering
IllegalOperationError — Het bestand is niet geopend en er kan niet naar worden geschreven.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
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 | () | methode |
public function writeBoolean(value:Boolean):void
Runtimeversies: | AIR 1.0 |
Schrijft een booleaanse waarde. Er wordt volgens de parameter value
één byte geschreven, 1 indien true
of 0 indien false
.
Parameters
value:Boolean — Een booleaanse waarde die bepaalt welke byte wordt geschreven. Als de parameter true is, wordt 1 geschreven; als de parameter false , wordt 0 geschreven.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
writeByte | () | methode |
public function writeByte(value:int):void
Runtimeversies: | AIR 1.0 |
Schrijft een byte. De lage 8 bits van de parameter worden gebruikt, de hoge 24 bits worden genegeerd.
Parameters
value:int — De waarde van een byte als geheel getal.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
writeBytes | () | methode |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Runtimeversies: | AIR 1.0 |
Schrijft een reeks van bytes vanuit de opgegeven bytearray bytes
, te beginnen op de byte die is opgegeven met offset
(met een op nul gebaseerde indexwaarde) met een lengte die is opgegeven met length
, naar de bestandsstream, bytestream of bytearray.
Wanneer de parameter length
wordt weggelaten, wordt de standaardlengte 0 gebruikt en wordt de gehele buffer geschreven, beginnend bij offset
. Wanneer de parameter offset
ook wordt weggelaten, wordt de gehele buffer geschreven.
Wanneer de parameter offset
of length
zich buiten het bereik bevindt, worden ze vastgeklemd aan het begin en het einde van de array bytes
.
Parameters
bytes:ByteArray — De bytearray die moet worden geschreven.
| |
offset:uint (default = 0 ) — Een op nul gebaseerde index die de positie in de array opgeeft waar met schrijven moet worden begonnen.
| |
length:uint (default = 0 ) — Een geheel getal zonder teken dat aangeeft tot hoever in de buffer moet worden geschreven.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
writeDouble | () | methode |
public function writeDouble(value:Number):void
Runtimeversies: | AIR 1.0 |
Schrijft een IEEE 754 drijvende-kommagetal (64-bits) met dubbele precisie.
Parameters
value:Number — Een drijvende-kommagetal (64 bits) met dubbele precisie.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
writeFloat | () | methode |
public function writeFloat(value:Number):void
Runtimeversies: | AIR 1.0 |
Schrijft een IEEE 754 drijvende-kommagetal (32-bits) met enkele precisie.
Parameters
value:Number — Een drijvende-kommagetal (32 bits) met enkele precisie.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
writeInt | () | methode |
public function writeInt(value:int):void
Runtimeversies: | AIR 1.0 |
Schrijft een 32-bits geheel getal met teken.
Parameters
value:int — De waarde van een byte als een geheel getal met teken.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
writeMultiByte | () | methode |
public function writeMultiByte(value:String, charSet:String):void
Runtimeversies: | AIR 1.0 |
Schrijft een multibyte-tekenreeks naar de bestandsstream, bytestream of byte-array met de opgegeven tekenset.
Parameters
value:String — De tekenreekswaarde die moet worden geschreven.
| |
charSet:String — De tekenreeks die de tekenset aangeeft die moet worden gebruikt. Mogelijke tekensetreeksen zijn onder andere shift-jis , cn-gb , iso-8859-1 en andere. Zie Ondersteunde tekensets voor een complete lijst.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
Verwante API-elementen
writeObject | () | methode |
public function writeObject(object:*):void
Runtimeversies: | AIR 1.0 |
Schrijft een object dat in AMF-indeling met serienummering is gecodeerd, naar de bestandsstream, bytestream of bytearray.
Parameters
object:* — Het object waarop serienummering moet worden toegepast.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
Verwante API-elementen
writeShort | () | methode |
public function writeShort(value:int):void
Runtimeversies: | AIR 1.0 |
Schrijft een 16-bits geheel getal. De lage 16 bits van de parameter worden gebruikt, de hoge 16 bits worden genegeerd.
Parameters
value:int — De waarde van een byte als geheel getal.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
writeUnsignedInt | () | methode |
public function writeUnsignedInt(value:uint):void
Runtimeversies: | AIR 1.0 |
Schrijft een 32-bits geheel getal zonder teken.
Parameters
value:uint — De waarde van een byte als een geheel getal zonder teken.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
writeUTF | () | methode |
public function writeUTF(value:String):void
Runtimeversies: | AIR 1.0 |
Schrijft een UTF-8-tekenreeks naar de bestandsstream, bytestream of byte-array. De lengte van de UTF-8-tekenreeks in bytes wordt eerst als een 16-bits geheel getal geschreven en wordt gevolgd door de bytes die de tekens van de tekenreeks vertegenwoordigen.
Parameters
value:String — De tekenreekswaarde die moet worden geschreven.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
RangeError — Als de tekenreeks langer is dan 65.535 tekens.
| |
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
writeUTFBytes | () | methode |
public function writeUTFBytes(value:String):void
Runtimeversies: | AIR 1.0 |
Schrijft een UTF-8-tekenreeks. Vergelijkbaar met writeUTF()
, maar voegt geen 16-bits woord als voorvoegsel toe aan de tekenreeks.
Parameters
value:String — De tekenreekswaarde die moet worden geschreven.
|
Gebeurtenissen
ioError: — U kunt niet naar het bestand schrijven (bijvoorbeeld omdat het niet aanwezig is). Deze gebeurtenis wordt alleen verzonden voor bestanden die voor asynchrone bewerkingen zijn geopend (met de methode openAsync() ).
|
Gegenereerde uitzondering
IOError — Het bestand is niet geopend; het bestand is geopend maar niet met schrijfmogelijkheden; of, in het geval van een bestand dat voor synchrone bewerkingen is geopend (met de methode open() ), het bestand kan niet worden geschreven (omdat het bijvoorbeeld niet aanwezig is).
|
close | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.CLOSE
Runtimeversies: | AIR 1.0 |
Geeft aan dat de stroom is gesloten door een expliciete aanroep van de methode close()
.
Event.CLOSE
definieert de waarde van de eigenschap type
van een close
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object waarvan de verbinding is gesloten. |
Verwante API-elementen
complete | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.COMPLETE
Runtimeversies: | AIR 1.0 |
Geeft aan dat het einde van de stroom is bereikt.
De constanteEvent.COMPLETE
definieert de waarde van de eigenschap type
van een complete
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het netwerkobject dat klaar is met laden. |
Verwante API-elementen
ioError | Gebeurtenis |
flash.events.IOErrorEvent
eigenschap IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Runtimeversies: | AIR 1.0 |
Geeft aan dat er een fout is opgetreden tijdens een asynchrone I/O-bewerking van het bestand.
Definieert de waarde van de eigenschaptype
van een gebeurtenisobject ioError
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
errorID | Een referentienummer dat aan de specifieke fout is gekoppeld (alleen AIR). |
target | Het netwerkobject dat de invoer-/uitvoerfout ondervindt. |
text | Tekst die moet worden weergegeven als foutbericht. |
outputProgress | Gebeurtenis |
flash.events.OutputProgressEvent
eigenschap OutputProgressEvent.type =
flash.events.OutputProgressEvent.OUTPUT_PROGRESS
Runtimeversies: | AIR 1.0 |
Geeft aan dat de gebufferde gegevens naar het bestand zijn geschreven.
Definieert de waarde van de eigenschaptype
van een gebeurtenisobject outputProgress
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
bytesPending | Het aantal bytes dat nog moet worden geschreven op het moment dat de listener de gebeurtenis verwerkt. |
bytesTotal | Het totaal aantal bytes dat uiteindelijk is geschreven als het schrijfproces slaagt. |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het FileStream-object dat de voortgang rapporteert. |
progress | Gebeurtenis |
flash.events.ProgressEvent
eigenschap ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS
Runtimeversies: | AIR 1.0 |
Geeft aan dat er nieuwe gegevens beschikbaar zijn in de stroom.
Definieert de waarde van de eigenschaptype
van een gebeurtenisobject progress
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
bytesLoaded | Het aantal items of bytes dat wordt geladen wanneer de listener de gebeurtenis verwerkt. |
bytesTotal | Het totale aantal items of bytes dat uiteindelijk wordt geladen wanneer het laadproces is voltooid. |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object dat de voortgang rapporteert. |
Wed Jun 13 2018, 11:42 AM Z