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 

ErrorEvent  - AS3

Paketflash.events
Klassepublic class ErrorEvent
VererbungErrorEvent Inheritance TextEvent Inheritance Event Inheritance Object
Unterklassen AsyncErrorEvent, AugmentedErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMDeviceGroupErrorEvent, DRMErrorEvent, DRMReturnVoucherErrorEvent, IOErrorEvent, RSLErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent, UncaughtErrorEvent

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

Ein Objekt setzt ein ErrorEvent-Objekt ab, wenn ein Fehler zum Fehlschlagen eines asynchronen Vorgangs führt.

Die ErrorEvent-Klasse definiert nur einen Typ von error-Ereignis: ErrorEvent.ERROR. Die ErrorEvent-Klasse dient auch als Basisklasse für verschiedene andere Fehlerereignisklassen, darunter AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SQLErrorEvent und UncaughtErrorEvent.

Sie können feststellen, ob es error-Ereignisse gibt, die keine Listener haben, indem Sie einen Listener für das uncaughtError-Ereignis (UncaughtErrorEvent.UNCAUGHT_ERROR) registrieren.

Ein nicht erfasster Fehler produziert auch ein Fehlerdialogfeld mit dem Fehlerereignis, wenn Inhalt in der Debugger-Version von Flash Player oder der Anwendung „AIR Debug Launcher“ (ADL) ausgeführt wird.

Beispiele anzeigen

Verwandte API-Elemente



Ö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
  errorID : int
[schreibgeschützt] Enthält die Verweisnummer, die dem spezifischen Fehler zugeordnet ist.
ErrorEvent
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtext : String
Bei einem textInput-Ereignis das bzw. die vom Benutzer eingegebene(n) Zeichen.
TextEvent
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Erstellt ein Ereignisobjekt, das Informationen über Fehlerereignisse enthält.
ErrorEvent
  
[override] Erstellt eine Kopie des ErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
ErrorEvent
 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 ErrorEvent-Objekts enthält.
ErrorEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  ERROR : String = "error"
[statisch] Definiert den Wert der Eigenschaft „type“ eines error-Ereignisobjekts.
ErrorEvent
Eigenschaftendetails

errorID

Eigenschaft
errorID:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 1.0, Flash Player 10.1

Enthält die Verweisnummer, die dem spezifischen Fehler zugeordnet ist. Bei einem selbst definierten ErrorEvent-Objekt entspricht diese Nummer dem Wert des im Konstruktor bereitgestellten id-Parameters.



Implementierung
    public function get errorID():int
Konstruktordetails

ErrorEvent

()Konstruktor
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)

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

Erstellt ein Ereignisobjekt, das Informationen über Fehlerereignisse 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 eines Fehlerereignisses: ErrorEvent.ERROR.
 
bubbles:Boolean (default = false) — Legt fest, ob das Ereignisobjekt eine Bubbling-Phase durchführt. 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.
 
text:String (default = "") — Der als Fehlermeldung anzuzeigende Text. Ereignis-Listener können über die Eigenschaft text auf diese Informationen zugreifen.
 
id:int (default = 0) — Eine mit dem spezifischen Fehler verknüpfte Referenznummer (wird nur in Adobe AIR unterstützt).
Methodendetails

clone

()Methode
override public function clone():Event

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

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

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

toString

()Methode 
override public function toString():String

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

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

[ErrorEvent type=Wert bubbles=Wert cancelable=Wert text=Wert errorID=Wert]

Hinweis: Der errorId-Wert, der von der toString()-Methode zurückgegeben wird, ist nur für Adobe AIR verfügbar. Während Flash Player 10.1 die errorID-Eigenschaft unterstützt, wird durch den Aufruf von toString() für das ErrorEvent-Objekt in Flash Player nicht der errorId-Wert bereitgestellt.

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

ERROR

Konstante
public static const ERROR:String = "error"

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

Definiert den Wert der Eigenschaft type eines error-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.
targetDas Objekt, bei dem der Netzwerkvorgang fehlschlägt.
textDer als Fehlermeldung anzuzeigende Text.

ErrorEventExample.as

Im folgenden Beispiel wird die Verwendung einer einzelnen Fehlerprozedur (errorHandler()), die mehrere Arten von Fehlerereignissen erfasst, demonstriert. Wenn ein ioError-Ereignis eintritt, versucht die Prozedur einen Ladevorgang aus dem Netzwerk. Hierbei wird ein securityError ausgelöst.

Hinweis: Dieses Beispiel funktioniert nicht, wenn sich eine Datei mit dem Namen „MissingFile.xml“ im gleichen Ordner wie die SWF-Datei befindet.

package {
    import flash.display.Sprite;
    import flash.net.URLLoader;
    import flash.net.URLRequest;
    import flash.events.*;

    public class ErrorEventExample extends Sprite {
        private var loader:URLLoader;
        private var request:URLRequest;
        
        public function ErrorEventExample() {
            loader = new URLLoader();
            loader.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
            loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, errorHandler);

            request = new URLRequest();
            loadFromFileSystem();
        }
        
        private function loadFromFileSystem():void {
            request.url = "MissingFile.xml";
            loader.load(request);
        }

        private function loadFromNetwork():void {
            request.url = "http://www.[yourDomain].com/MissingFile.xml";
            loader.load(request);
        }
        
        private function errorHandler(event:ErrorEvent):void {
            trace("errorHandler: " + event);
            if(event is IOErrorEvent) {
                loadFromNetwork();
            }
        }
    }
}




[ 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.