ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.events 

AVHTTPStatusEvent  - AS3

Paketflash.events
Klassepublic class AVHTTPStatusEvent
VererbungAVHTTPStatusEvent Inheritance Event Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Die Anwendung sendet AVHTTPStatusEvent-Objekte, wenn eine Netzwerkanfrage einen HTTP-Statuscode zurückgibt.

AVHTTPStatusEvent-Objekte werden immer vor Fehler- oder Abschlussereignissen gesendet. Ein AVHTTPStatusEvent-Objekt muss nicht unbedingt auf einen Fehlerzustand hinweisen; es reflektiert einfach den HTTP-Statuscode (sofern vorhanden), der vom Netzwerkstapel bereitgestellt wird. Einige Flash Player-Umgebungen sind eventuell nicht in der Lage, HTTP-Statuscodes zu erfassen; in diesen Fällen wird immer ein Statuscode 0 gemeldet.

In Flash Player gibt es nur einen Typ HTTPStatus-Ereignis: httpStatus. In der AIR-Laufzeitumgebung kann ein FileReference, URLLoader oder URLStream registriert werden, um auf httpResponseStatus zu warten, wozu die Eigenschaften responseURL und responseHeaders gehören. Diese Eigenschaften sind in einem httpStatus-Ereignis nicht definiert.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
  responseHeaders : Array
Die Antwortheader, die die Antwort zurückgegeben hat, als Array von URLRequestHeader-Objekten.
AVHTTPStatusEvent
  responseURL : String
Die URL, von der die Antwort zurückgegeben wurde.
AVHTTPStatusEvent
  status : int
[schreibgeschützt] Der vom Server zurückgegebene HTTP-Statuscode.
AVHTTPStatusEvent
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
AVHTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, responseUrl:String = null, responseHeaders:Array = null)
Erstellt ein Ereignisobjekt, das Informationen über HTTP-Status-Ereignisse enthält.
AVHTTPStatusEvent
  
[override] Erstellt eine Kopie des AVHTTPStatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
AVHTTPStatusEvent
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
[override] Gibt eine Zeichenfolge zurück, die alle Eigenschaften des AVHTTPStatusEvent-Objekts enthält.
AVHTTPStatusEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  AV_HTTP_RESPONSE_STATUS : String = "avHttpResponseStatus"
[statisch] Anders als das httpStatus-Ereignis wird das httpResponseStatus-Ereignis ausgelöst, bevor Antwortdaten vorliegen.
AVHTTPStatusEvent
Eigenschaftendetails

responseHeaders

Eigenschaft
responseHeaders:Array

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Lite 4

Die Antwortheader, die die Antwort zurückgegeben hat, als Array von URLRequestHeader-Objekten.



Implementierung
    public function get responseHeaders():Array
    public function set responseHeaders(value:Array):void

Verwandte API-Elemente

responseURL

Eigenschaft 
responseURL:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Lite 4

Die URL, von der die Antwort zurückgegeben wurde. Bei Umleitungen ist dies eine andere URL als die Anforderungs-URL.



Implementierung
    public function get responseURL():String
    public function set responseURL(value:String):void

status

Eigenschaft 
status:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Der vom Server zurückgegebene HTTP-Statuscode. So zeigt der Wert 404 beispielsweise an, dass der Server den angeforderten URI nicht gefunden hat. HTTP-Statuscodes finden Sie in den Abschnitten 10.4 und 10.5 der HTTP-Spezifikation unter http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.

Wenn Flash Player oder AIR keinen Statuscode vom Server erhält oder keine Verbindung herstellen kann, wird der Standardwert 0 (null) an den Code übergeben. Dieser Wert kann von jedem Player generiert werden (wenn beispielsweise eine fehlerhafte URL angefordert wird). Er wird aber in jedem Fall vom Flash Player Plug-In generiert, wenn es in einem der folgenden Browser ausgeführt wird, die dem Player grundsätzlich keine HTTP-Statuscodes übergeben: Netscape, Mozilla, Safari, Opera und Internet Explorer für Macintosh.



Implementierung
    public function get status():int
Konstruktordetails

AVHTTPStatusEvent

()Konstruktor
public function AVHTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, responseUrl:String = null, responseHeaders:Array = null)

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt ein Ereignisobjekt, das Informationen über HTTP-Status-Ereignisse enthält. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.

Parameter
type:String — Der Ereignistyp. Ereignis-Listener können über die übernommene Eigenschaft type auf diese Informationen zugreifen. Es gibt nur einen Typ von HTTPStatus-Ereignis: AVHTTPStatusEvent.HTTP_STATUS.
 
bubbles:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die übernommene Eigenschaft bubbles auf diese Informationen zugreifen.
 
cancelable:Boolean (default = false) — Bestimmt, ob das Ereignisobjekt abgebrochen werden kann. Ereignis-Listener können über die übernommene Eigenschaft cancelable auf diese Informationen zugreifen.
 
status:int (default = 0) — Numerischer Status. Ereignis-Listener können über die Eigenschaft status auf diese Informationen zugreifen.
 
responseUrl:String (default = null)
 
responseHeaders:Array (default = null)

Verwandte API-Elemente

Methodendetails

clone

()Methode
override public function clone():Event

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt eine Kopie des AVHTTPStatusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

Rückgabewerte
Event — Ein neues AVHTTPStatusEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.

toString

()Methode 
override public function toString():String

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 9, Flash Lite 4

Gibt eine Zeichenfolge zurück, die alle Eigenschaften des AVHTTPStatusEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[AVHTTPStatusEvent type=Wert bubbles=Wert cancelable=Wert status=Wert]

Rückgabewerte
String — Eine Zeichenfolge, die alle Eigenschaften des AVHTTPStatusEvent-Objekts enthält.
Konstantendetails

AV_HTTP_RESPONSE_STATUS

Konstante
public static const AV_HTTP_RESPONSE_STATUS:String = "avHttpResponseStatus"

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Lite 4

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.

Die AVHTTPStatusEvent.HTTP_RESPONSE_STATUS-Konstante definiert den Wert der type-Eigenschaft eines httpResponseStatus-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
responseURLDie URL, von der die Antwort zurückgegeben wurde.
responseHeadersDie Antwortheader, die die Antwort zurückgegeben hat, als Array von URLRequestHeader-Objekten.
statusDer vom Server zurückgegebene HTTP-Statuscode.
targetDas Netzwerkobjekt, das den HTTP-Statuscode empfängt.

Verwandte API-Elemente





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.