Paket | flash.net |
Klasse | public class URLStream |
Vererbung | URLStream EventDispatcher Object |
Implementiert | IDataInput |
Unterklassen | AVURLStream |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Die Lesevorgänge in „URLStream“ sind ungeblockt. Das heißt, dass Sie die Eigenschaft bytesAvailable
verwenden müssen, um zu ermitteln, ob genügend Daten vorhanden sind, bevor Sie den Lesevorgang starten. Wenn nicht genügend Daten vorhanden sind, wird eine EOFError
-Ausnahme ausgelöst.
Alle Binärdaten werden standardmäßig im Big Endian-Format kodiert, wobei das höchstwertige Byte an erster Stelle steht.
Für URL-Downloads mit der URLStream-Klasse gelten dieselben Sicherheitsregeln wie für URLLoader-Objekte. Richtliniendateien können nach Bedarf heruntergeladen werden. Lokale Dateisicherheitsregeln werden erzwungen, und ggf. werden Sicherheitswarnungen ausgegeben.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
bytesAvailable : uint [schreibgeschützt]
Gibt für die zum Lesen verfügbaren Daten im Eingabepuffer die Anzahl der Byte an. | URLStream | ||
connected : Boolean [schreibgeschützt]
Gibt an, ob dieses URLStream-Objekt zurzeit verbunden ist. | URLStream | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
endian : String
Gibt die Byte-Reihenfolge der Daten an. | URLStream | ||
objectEncoding : uint
Steuert die beim Schreiben oder Lesen eines Objekts verwendete Version von Action Message Format (AMF). | URLStream |
Methode | Definiert von | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
Schließt den Stream unmittelbar und bricht den Download-Vorgang ab. | URLStream | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Startet den Download der im Parameter „request“ angegebenen URL. | URLStream | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Liest einen booleschen Wert aus dem Stream. | URLStream | ||
Liest ein Byte mit Vorzeichen aus dem Stream. | URLStream | ||
Liest „length“-Byte Daten aus dem Stream. | URLStream | ||
Liest eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit aus dem Stream. | URLStream | ||
Liest eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit aus dem Stream. | URLStream | ||
Liest eine 32-Bit-Ganzzahl mit Vorzeichen aus dem Stream. | URLStream | ||
Liest einen Multibyte-String der angegebenen Länge unter Verwendung des angegebenen Zeichensatzes vom Bytedatenstream. | URLStream | ||
readObject():*
Liest ein im Action Message Format (AMF) kodiertes Objekt vom Socketserver. | URLStream | ||
Liest eine 16-Bit-Ganzzahl mit Vorzeichen aus dem Stream. | URLStream | ||
Liest ein Byte ohne Vorzeichen aus dem Stream. | URLStream | ||
Liest eine 32-Bit-Ganzzahl ohne Vorzeichen aus dem Stream. | URLStream | ||
Liest eine 16-Bit-Ganzzahl ohne Vorzeichen aus dem Stream. | URLStream | ||
Liest einen UTF-8-String aus dem Bytestream. | URLStream | ||
Liest eine Folge von length-UTF-8-Byte aus dem Bytestream und gibt einen String zurück. | URLStream | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
Wird nach dem erfolgreichen Laden von Daten ausgelöst. | URLStream | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Wird ausgelöst, wenn ein Aufruf der URLStream.load()-Methode versucht, über HTTP auf Daten zuzugreifen und Adobe AIR den Statuscode für die Anforderung erkennen und zurückgeben kann. | URLStream | |||
Wird ausgelöst, wenn ein URLStream.load() versucht, auf Daten über HTTP zuzugreifen, und Flash Player oder Adobe AIR den Statuscode für die Anforderung erkennen und zurückgeben kann. | URLStream | |||
Wird beim Auftreten eines I/O-Fehlers ausgelöst, durch den der Ladevorgang fehlschlägt. | URLStream | |||
Wird beim Start eines Ladevorgangs ausgelöst. | URLStream | |||
Wird ausgelöst, wenn während des Download-Vorgangs Daten empfangen werden. | URLStream | |||
Wird ausgelöst, wenn ein URLStream.load()-Aufruf versucht, Daten von einem Server außerhalb der Sicherheitssandbox zu laden. | URLStream |
bytesAvailable | Eigenschaft |
bytesAvailable:uint
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt für die zum Lesen verfügbaren Daten im Eingabepuffer die Anzahl der Byte an. Ihr Code muss die Eigenschaft bytesAvailable
aufrufen, um sicherzustellen, dass genügend Daten verfügbar sind, bevor Sie diese mit einer der read
-Methoden lesen.
Implementierung
public function get bytesAvailable():uint
connected | Eigenschaft |
connected:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt an, ob dieses URLStream-Objekt zurzeit verbunden ist. Beim Aufruf dieser Eigenschaft wird der Wert true
zurückgegeben, wenn das URLStream-Objekt verbunden ist, oder andernfalls false
.
Implementierung
public function get connected():Boolean
endian | Eigenschaft |
endian:String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt die Byte-Reihenfolge der Daten an. Mögliche Werte sind Endian.BIG_ENDIAN
oder Endian.LITTLE_ENDIAN
.
Der Standardwert ist Endian.BIG_ENDIAN.
Implementierung
public function get endian():String
public function set endian(value:String):void
Verwandte API-Elemente
objectEncoding | Eigenschaft |
objectEncoding:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Steuert die beim Schreiben oder Lesen eines Objekts verwendete Version von Action Message Format (AMF).
Implementierung
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
Verwandte API-Elemente
close | () | Methode |
public function close():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schließt den Stream unmittelbar und bricht den Download-Vorgang ab. Nach dem Aufrufen der close()
-Methode können aus dem Stream keine Daten gelesen werden.
Auslöser
IOError — Der Stream konnte nicht geschlossen werden, oder der Stream war nicht geöffnet.
|
load | () | Methode |
public function load(request:URLRequest):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Startet den Download der im Parameter request
angegebenen URL.
Hinweis: Enthält eine geladene Datei Nicht-ASCII-Zeichen (wie sie z. B. in vielen Sprachen außerhalb des englischen Sprachraums vorkommen), wird empfohlen, dass Sie die Datei im Format UTF-8 oder UTF-16 und nicht in einem Unicode-fremden Format (z. B. ASCII) speichern.
Wenn der Ladevorgang unmittelbar fehlschlägt, wird eine IOError- oder eine SecurityError-Ausnahme (mit dem lokalen Dateisicherheitsfehler) mit der Beschreibung des Fehlers ausgegeben. Andernfalls wird ein open
-Ereignis ausgelöst, wenn der URL-Download erfolgreich gestartet wird, bzw. ein Fehlerereignis, wenn ein Fehler auftritt.
Standardmäßig müssen die aufrufende SWF-Datei und die von Ihnen geladene URL in genau der gleichen Domäne sein. Eine SWF-Datei unter www.adobe.com kann beispielsweise nur Daten laden, die sich ebenfalls unter www.adobe.com befinden. Legen Sie eine URL-Richtliniendatei auf dem Server ab, der die Daten hostet, um Daten aus einer anderen Domäne zu laden.
In Flash Player können Sie keine Verbindung mit normalerweisen reservierten Ports herstellen. Eine vollständige Liste der gesperrten Ports finden Sie unter „Beschränken von Netzwerk-APIs“ im ActionScript 3.0 Entwicklerhandbuch.
In Flash Player können Sie eine SWF-Datei daran hindern, diese Methode zu verwenden, indem Sie den allowNetworking
-Parameter des object
- und embed
-Tags auf der HTML-Seite setzen, die den SWF-Inhalt enthält.
Wenn Sie in Flash Player 10 und höher und in AIR 1.5 und höher einen Multipart-Content-Type (z. B. „multipart/form-data“) verwenden, der ein Upload enthält (angegeben durch einen „filename“-Parameter in einem „content-disposition“-Header innerhalb des POST-Body), unterliegt die POST-Methode den auf Uploads angewendeten Sicherheitsregeln:
- Der POST-Vorgang muss als Reaktion auf eine durch den Benutzer initiierte Aktion, z. B. Mausklick oder Tastendruck, erfolgen.
- Ist die POST-Methode domänenübergreifend (das POST-Ziel befindet sich auf einem anderen Server als die SWF-Datei, die die POST-Anforderung sendet), so muss der Zielserver eine URL-Richtliniendatei bereitstellen, die den domänenübergreifenden Zugriff erlaubt.
Für alle mehrteiligen Content-Typen muss ebenfalls die Syntax nach Standard RFC2046 gültig sein. Scheint die Syntax ungültig zu sein, so unterliegt die POST-Methode den Sicherheitsregeln für Uploads.
Diese Regeln gelten auch für AIR-Inhalt in anwendungsfremden Sandboxen. In Adobe AIR dagegen ist Inhalt in der Anwendungssandbox (mit der AIR-Anwendung installierter Inhalt) nicht durch diese Sicherheitseinschränkungen beschränkt.
Weitere Informationen zum Thema Sicherheit finden Sie im Flash Player Developer Center im Abschnitt Sicherheit.
In AIR kann sich ein URLRequest-Objekt für das httpResponse
-Statusereignis registrieren. Anders als das httpStatus
-Ereignis wird das httpResponseStatus
-Ereignis ausgelöst, bevor Antwortdaten vorliegen. Außerdem enthält das httpResponseStatus
-Ereignis Werte für die Eigenschaften responseHeaders
und responseURL
(die für ein httpStatus
-Ereignis nicht definiert sind). Beachten Sie, dass das Ereignis httpResponseStatus
(falls vorhanden) vor (und zusätzlich zu) jedem complete
- oder error
-Ereignis gesendet wird.
Wenn es einen httpResponseStatus
Ereignis-Listener gibt, wird der Rumpf der Antwortmeldung immer gesendet, und HTTP-Statuscodeantworten resultierten immer in einem complete
-Ereignis. Dies ist unabhängig davon wahr, ob der HTTP-Antwortstatuscode einen Erfolg oder einen Fehler anzeigt.
Wenn es in AIR keine httpResponseStatus
-Ereignis-Listener gibt, ist das Verhalten basierend auf der SWFAIR-Version unterschiedlich:
- Bei SWF 9-Inhalten wird der Hauptteil der HTTP-Antwortnachricht nur dann gesendet, wenn der HTTP-Antwortstatuscode Erfolg anzeigt. Andernfalls (wenn ein Fehler vorliegt) wird kein Rumpf gesendet und das URLRequest-Objekt löst ein IOError-Ereignis aus.
- Bei SWF 10-Inhalten wird der Hauptteil der HTTP-Antwortnachricht immer gesendet. Wenn ein Fehler vorliegt, löst das URLRequest-Objekt ein IOError-Ereignis aus.
Parameter
request:URLRequest — Ein URLRequest-Objekt, das die herunterzuladende URL angibt. Wenn der Wert dieses Parameters oder der Eigenschaft URLRequest.url des übergebenen URLRequest-Objekts null ist, gibt die Anwendung einen Nullzeiger-Fehler aus.
|
Ereignisse
complete: — Wird nach dem erfolgreichen Laden von Daten ausgelöst. Wenn es einen httpResponseStatus -Ereignis-Listener gibt, löst das URLRequest-Objekt auch ein complete -Ereignis aus, unabhängig davon, ob der HTTP-Antwortstatuscode einen Erfolg oder einen Fehler angibt.
| |
httpStatus: — Wenn der Zugriff über HTTP erfolgt und die aktuelle Umgebung den Empfang von Statuscodes unterstützt, werden diese Ereignisse möglicherweise zusätzlich zu allen complete - oder error -Ereignissen empfangen.
| |
httpResponseStatus: — Wird ausgelöst, wenn ein Aufruf der load() -Methode versucht, über HTTP auf Daten zuzugreifen und Adobe AIR den Statuscode für die Anforderung erkennen und zurückgeben kann.
| |
ioError: — Der Ladevorgang konnte nicht abgeschlossen werden.
| |
open: — Wird beim Start eines Ladevorgangs ausgelöst.
| |
securityError: — Bei einem Ladevorgang wurde versucht, Daten von einem Server außerhalb der Sicherheitssandbox der aufrufenden Funktion abzurufen. Sie können dies umgehen, indem Sie eine Richtliniendatei auf dem Server verwenden.
|
Auslöser
ArgumentError — Bestimmte nicht zulässige HTTP-Anforderungsheader sind möglicherweise in URLRequest.requestHeader -Objekten nicht enthalten. Weitere Informationen finden Sie in der Beschreibung der URLRequestHeader-Klasse.
| |
MemoryError — Dieser Fehler kann folgende Ursachen haben:
| |
SecurityError — Über lokale nicht vertrauenswürdige SWF-Dateien kann keine Verbindung mit dem Internet hergestellt werden. Sie können dieses Problem umgehen, indem Sie diese SWF-Datei neu als lokal mit Netzwerk oder als vertrauenswürdig klassifizieren.
| |
SecurityError — Sie versuchen, eine Verbindung mit einem normalerweise reservierten Port herzustellen. Eine vollständige Liste der gesperrten Ports finden Sie unter „Beschränken von Netzwerk-APIs“ im ActionScript 3.0 Entwicklerhandbuch.
|
readBoolean | () | Methode |
public function readBoolean():Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest einen booleschen Wert aus dem Stream. Es wird ein einzelnes Byte gelesen und true
zurückgegeben, wenn das Byte ungleich 0 ist, oder andernfalls false
.
Boolean — True wird zurückgegeben, wenn der Bytewert nicht null ist, andernfalls false .
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readByte | () | Methode |
public function readByte():int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest ein Byte mit Vorzeichen aus dem Stream.
Der Rückgabewert liegt im Bereich von -128 bis 127.
Rückgabewerteint — Wert im Bereich -128...127.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readBytes | () | Methode |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest length
Byte Daten aus dem Stream. Die Bytedaten werden ab der im Parameter offset
festgelegten Position in das im Parameter bytes
angegebene ByteArray-Objekt gelesen.
Parameter
bytes:ByteArray — Das ByteArray-Objekt, in das die Daten gelesen werden.
| |
offset:uint (default = 0 ) — Der Offset innerhalb des mit bytes angegebenen Bereichs, ab dem das Lesen der Daten beginnt. Standardeinstellung ist 0.
| |
length:uint (default = 0 ) — Die Anzahl der zu lesenden Byte. Der Standardwert 0 bewirkt, dass alle verfügbaren Daten gelesen werden.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readDouble | () | Methode |
public function readDouble():Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit aus dem Stream.
RückgabewerteNumber — Eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit aus dem Stream.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readFloat | () | Methode |
public function readFloat():Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit aus dem Stream.
RückgabewerteNumber — Eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit aus dem Stream.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readInt | () | Methode |
public function readInt():int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine 32-Bit-Ganzzahl mit Vorzeichen aus dem Stream.
Der Rückgabewert liegt im Bereich von -2147483648 bis 2147483647.
Rückgabewerteint — Wert im Bereich -2147483648...2147483647.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readMultiByte | () | Methode |
public function readMultiByte(length:uint, charSet:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest einen Multibyte-String der angegebenen Länge unter Verwendung des angegebenen Zeichensatzes vom Bytedatenstream.
Parameter
length:uint — Die Anzahl der aus dem Bytestream zu lesenden Byte.
| |
charSet:String — Der String, der den zum Interpretieren der Byte zu verwendenden Zeichensatz angibt. Mögliche Zeichensatz-Strings sind u. a. "shift_jis" , "CN-GB" und "iso-8859-1" . Eine vollständige Liste finden Sie unter Unterstützte Zeichensätze.
Hinweis: Wird der Wert des |
String — Ein UTF-8-kodierter String.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
|
readObject | () | Methode |
public function readObject():*
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest ein im Action Message Format (AMF) kodiertes Objekt vom Socketserver.
Rückgabewerte* — Das deserialisierte Objekt.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
Verwandte API-Elemente
readShort | () | Methode |
public function readShort():int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine 16-Bit-Ganzzahl mit Vorzeichen aus dem Stream.
Der Rückgabewert liegt im Bereich von -32768 bis 32767.
Rückgabewerteint — Wert im Bereich -32768...32767.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readUnsignedByte | () | Methode |
public function readUnsignedByte():uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest ein Byte ohne Vorzeichen aus dem Stream.
Der Rückgabewert liegt im Bereich von 0 bis 255.
Rückgabewerteuint — Wert im Bereich 0...255.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readUnsignedInt | () | Methode |
public function readUnsignedInt():uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine 32-Bit-Ganzzahl ohne Vorzeichen aus dem Stream.
Der Rückgabewert liegt im Bereich von 0 bis 4294967295.
Rückgabewerteuint — Wert im Bereich 0...4294967295.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readUnsignedShort | () | Methode |
public function readUnsignedShort():uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine 16-Bit-Ganzzahl ohne Vorzeichen aus dem Stream.
Der Rückgabewert liegt im Bereich von 0 bis 65535.
Rückgabewerteuint — Wert im Bereich 0...65535.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readUTF | () | Methode |
public function readUTF():String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest einen UTF-8-String aus dem Bytestream. Es wird davon ausgegangen, dass dem String eine short-Ganzzahl ohne Vorzeichen mit der Länge in Byte vorangestellt ist.
RückgabewerteString — Ein UTF-8-String.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
readUTFBytes | () | Methode |
public function readUTFBytes(length:uint):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Liest eine Folge von length
-UTF-8-Byte aus dem Bytestream und gibt einen String zurück.
Parameter
length:uint — Eine Abfolge von UTF-8-Byte.
|
String — Ein durch die Bytedarstellung von Zeichen erstellter UTF-8-String der angegebenen Länge.
|
Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden. Wenn eine lokale SWF-Datei eine Sicherheitswarnung auslöst, lässt Flash Player nicht zu, dass die URLStream-Daten für ActionScript verfügbar sind. In diesem Fall gibt die Eigenschaft bytesAvailable auch dann 0 zurück, wenn Daten empfangen wurden, und eine der Lesemethoden löst eine EOFError-Ausnahme aus.
| |
IOError — Ein I/O-Fehler ist im Stream aufgetreten, oder der Stream ist nicht geöffnet.
|
complete | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.COMPLETE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird nach dem erfolgreichen Laden von Daten ausgelöst.
DieEvent.COMPLETE
-Konstante definiert den Wert der type
-Eigenschaft eines complete
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, dessen Ladevorgang beendet ist. |
httpResponseStatus | Ereignis |
flash.events.HTTPStatusEvent
Eigenschaft HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_RESPONSE_STATUS
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, AIR 1.0, Flash Lite 4 |
Wird ausgelöst, wenn ein Aufruf der URLStream.load()
-Methode versucht, über HTTP auf Daten zuzugreifen und Adobe AIR den Statuscode für die Anforderung erkennen und zurückgeben kann.
Wenn ein URLStream-Objekt für ein httpStatusEvent
-Eigenschaft registriert wird, werden Fehlerantworten zugestellt, als ob es sich um Inhalt handelt. Anstatt ein ioError
-Ereignis auszulösen, löst der URLStream progress
- und complete
-Ereignisse aus, während die Fehlerdaten in den URLStream geladen werden.
httpStatus
-Ereignis wird das httpResponseStatus
-Ereignis ausgelöst, bevor Antwortdaten vorliegen. Außerdem enthält das httpResponseStatus
-Ereignis Werte für die Eigenschaften responseHeaders
und responseURL
(die für ein httpStatus
-Ereignis nicht definiert sind). Beachten Sie, dass das Ereignis httpResponseStatus
(falls vorhanden) vor (und zusätzlich zu) jedem complete
- oder error
-Ereignis gesendet wird.
Die HTTPStatusEvent.HTTP_RESPONSE_STATUS
-Konstante definiert den Wert der type
-Eigenschaft eines httpResponseStatus
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
responseURL | Die URL, von der die Antwort zurückgegeben wurde. |
responseHeaders | Die Antwortheader, die die Antwort zurückgegeben hat, als Array von URLRequestHeader-Objekten. |
status | Der vom Server zurückgegebene HTTP-Statuscode. |
redirected | Gibt an, ob die Antwort das Ergebnis einer Weiterleitung ist. |
target | Das Netzwerkobjekt, das den HTTP-Statuscode empfängt. |
Verwandte API-Elemente
httpStatus | Ereignis |
flash.events.HTTPStatusEvent
Eigenschaft HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird ausgelöst, wenn ein URLStream.load()
versucht, auf Daten über HTTP zuzugreifen, und Flash Player oder Adobe AIR den Statuscode für die Anforderung erkennen und zurückgeben kann. (Diese Informationen können in einigen Browser-Umgebungen möglicherweise nicht bereitgestellt werden.) Beachten Sie, dass das Ereignis httpStatus
(falls vorhanden) vor (und zusätzlich zu) jedem complete
- oder error
-Ereignis gesendet wird.
HTTPStatusEvent.HTTP_STATUS
-Konstante definiert den Wert der type
-Eigenschaft eines httpStatus
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
status | Der vom Server zurückgegebene HTTP-Statuscode. |
target | Das Netzwerkobjekt, das den HTTP-Statuscode empfängt. |
Verwandte API-Elemente
ioError | Ereignis |
flash.events.IOErrorEvent
Eigenschaft IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird beim Auftreten eines I/O-Fehlers ausgelöst, durch den der Ladevorgang fehlschlägt.
Definiert den Wert der Eigenschafttype
eines ioError
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
errorID | Die Referenznummer des spezifischen Fehlers (nur AIR). |
target | Das Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt. |
text | Der als Fehlermeldung anzuzeigende Text. |
Verwandte API-Elemente
open | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.OPEN
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird beim Start eines Ladevorgangs ausgelöst.
DieEvent.OPEN
-Konstante definiert den Wert der type
-Eigenschaft eines open
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, über das eine Verbindung geöffnet wurde. |
Verwandte API-Elemente
progress | Ereignis |
flash.events.ProgressEvent
Eigenschaft ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird ausgelöst, wenn während des Download-Vorgangs Daten empfangen werden. Empfangene Daten können mit den Methoden der URLStream-Klasse sofort gelesen werden.
Definiert den Wert der Eigenschafttype
eines progress
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
bytesLoaded | Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet. |
bytesTotal | Die Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden. |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, dessen Fortschritt protokolliert wird. |
Verwandte API-Elemente
securityError | Ereignis |
flash.events.SecurityErrorEvent
Eigenschaft SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird ausgelöst, wenn ein URLStream.load()
-Aufruf versucht, Daten von einem Server außerhalb der Sicherheitssandbox zu laden.
SecurityErrorEvent.SECURITY_ERROR
definiert den Wert der type
-Eigenschaft eines securityError
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, das den Sicherheitsfehler ausgibt. |
text | Der als Fehlermeldung anzuzeigende Text. |
Verwandte API-Elemente
Legen Sie zur Ausführung des Beispiels eine Datei mit dem Namen „URLStreamExample.swf“ in dem Verzeichnis ab, in dem sich die SWF-Datei befindet.
package { import flash.display.Sprite; import flash.errors.*; import flash.events.*; import flash.net.URLRequest; import flash.net.URLStream; public class URLStreamExample extends Sprite { private static const ZLIB_CODE:String = "CWS"; private var stream:URLStream; public function URLStreamExample() { stream = new URLStream(); var request:URLRequest = new URLRequest("URLStreamExample.swf"); configureListeners(stream); try { stream.load(request); } catch (error:Error) { trace("Unable to load requested URL."); } } private function configureListeners(dispatcher:EventDispatcher):void { dispatcher.addEventListener(Event.COMPLETE, completeHandler); dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler); dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); dispatcher.addEventListener(Event.OPEN, openHandler); dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler); dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); } private function parseHeader():void { trace("parseHeader"); trace("isCompressed: " + isCompressed()); trace("version: " + stream.readByte()); } private function isCompressed():Boolean { return (stream.readUTFBytes(3) == ZLIB_CODE); } private function completeHandler(event:Event):void { trace("completeHandler: " + event); parseHeader(); } private function openHandler(event:Event):void { trace("openHandler: " + event); } private function progressHandler(event:Event):void { trace("progressHandler: " + event); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function httpStatusHandler(event:HTTPStatusEvent):void { trace("httpStatusHandler: " + event); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } } }
Tue Jun 12 2018, 10:04 AM Z