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 

IOErrorEvent  - AS3

Paketflash.events
Klassepublic class IOErrorEvent
VererbungIOErrorEvent Inheritance ErrorEvent Inheritance TextEvent Inheritance Event Inheritance Object

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

Ein IOErrorEvent-Objekt wird ausgelöst, wenn ein Eingabe- oder Ausgabevorgang aufgrund eines Fehlers fehlschlägt.

Sie können prüfen, ob error-Ereignisse ohne Listener vorliegen, indem Sie die Debugger-Version von Flash Player oder AIR Debug Launcher (ADL) verwenden. Es wird der String angezeigt, der vom text-Parameter des IOErrorEvent-Konstruktors definiert 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
 InheritederrorID : 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
  
IOErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Erstellt ein Ereignisobjekt, das bestimmte Informationen über ioError-Ereignisse enthält.
IOErrorEvent
  
[override] Erstellt eine Kopie des IOErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
IOErrorEvent
 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 IOErrorEvent-Objekts enthält.
IOErrorEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
  IO_ERROR : String = "ioError"
[statisch] Definiert den Wert der Eigenschaft „type“ eines ioError-Ereignisobjekts.
IOErrorEvent
  STANDARD_ERROR_IO_ERROR : String = "standardErrorIoError"
[statisch] Das standardErrorIoError-Ereignis wird abgesetzt, wenn beim Lesen von Daten aus dem standardError-Stream eines NativeProcess-Objekts ein Fehler auftritt.
IOErrorEvent
  STANDARD_INPUT_IO_ERROR : String = "standardInputIoError"
[statisch] Das standardInputIoError-Ereignis wird abgesetzt, wenn beim Schreiben von Daten in den standardInput-Stream eines NativeProcess-Objekts ein Fehler auftritt.
IOErrorEvent
  STANDARD_OUTPUT_IO_ERROR : String = "standardOutputIoError"
[statisch] Das standardOutputIoError-Ereignis wird abgesetzt, wenn beim Lesen von Daten aus dem standardOutput-Stream eines NativeProcess-Objekts ein Fehler auftritt.
IOErrorEvent
Konstruktordetails

IOErrorEvent

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

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

Erstellt ein Ereignisobjekt, das bestimmte Informationen über ioError-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 eines Eingabe/Ausgabe-Fehlerereignisses: IOErrorEvent.IO_ERROR.
 
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.
 
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).

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 IOErrorEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

Rückgabewerte
Event — Ein neues IOErrorEvent-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 IOErrorEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[IOErrorEvent type=Wert bubbles=Wert cancelable=Wert text=Wert errorID=Wert] Die errorId-Eigenschaft ist nur in Adobe AIR verfügbar

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

IO_ERROR

Konstante
public static const IO_ERROR:String = "ioError"

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

Definiert den Wert der Eigenschaft type eines ioError-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.
errorIDDie Referenznummer des spezifischen Fehlers (nur AIR).
targetDas Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt.
textDer als Fehlermeldung anzuzeigende Text.

Verwandte API-Elemente

STANDARD_ERROR_IO_ERROR

Konstante 
public static const STANDARD_ERROR_IO_ERROR:String = "standardErrorIoError"

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

Das standardErrorIoError-Ereignis wird abgesetzt, wenn beim Lesen von Daten aus dem standardError-Stream eines NativeProcess-Objekts ein Fehler auftritt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesNein.
cancelableNein. Es gibt kein Standardverhalten, das abgebrochen werden kann.
errorIDDie Verweisnummer, die dem spezifischen Fehler zugeordnet ist.
targetDas Objekt, bei dem der Fehler aufgetreten ist.
textDer als Fehlermeldung anzuzeigende Text.

STANDARD_INPUT_IO_ERROR

Konstante 
public static const STANDARD_INPUT_IO_ERROR:String = "standardInputIoError"

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

Das standardInputIoError-Ereignis wird abgesetzt, wenn beim Schreiben von Daten in den standardInput-Stream eines NativeProcess-Objekts ein Fehler auftritt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesNein.
cancelableNein. Es gibt kein Standardverhalten, das abgebrochen werden kann.
errorIDDie Verweisnummer, die dem spezifischen Fehler zugeordnet ist.
targetDas Objekt, bei dem der Fehler aufgetreten ist.
textDer als Fehlermeldung anzuzeigende Text.

STANDARD_OUTPUT_IO_ERROR

Konstante 
public static const STANDARD_OUTPUT_IO_ERROR:String = "standardOutputIoError"

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

Das standardOutputIoError-Ereignis wird abgesetzt, wenn beim Lesen von Daten aus dem standardOutput-Stream eines NativeProcess-Objekts ein Fehler auftritt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesNein.
cancelableNein. Es gibt kein Standardverhalten, das abgebrochen werden kann.
errorIDDie Verweisnummer, die dem spezifischen Fehler zugeordnet ist.
targetDas Objekt, bei dem der Fehler aufgetreten ist.
textDer als Fehlermeldung anzuzeigende Text.

IOErrorEventExample.as

Im folgenden Beispiel wird anhand der Klasse IOErrorEventExample gezeigt, wie ein Fehlerereignisobjekt ausgelöst wird, wenn versucht wird, eine nicht vorhandene Datei zu laden. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Der Klassenkonstruktor erstellt eine neue Instanz eines URLLoader-Objekts und weist ihr die Variable loader zu.
  2. Mit der URLLoader-Instanz wird ein Ereignis-Listener vom Typ ioError instanziiert, die mit der Abonnentenmethode ioErrorHandler() verknüpft ist. Die Methode dient zum Drucken von Informationen über das Ereignis mithilfe der Methode trace().
  3. Der Konstruktor erstellt eine neue Instanz eines URLRequest-Objekts (request) und übergibt dabei MissingFile.xml, damit der Dateiname und -speicherort bekannt sind.
  4. Die Variable request wird anschließend an loader.load() übergeben. Diese Methode versucht, die fehlende Datei zu laden. Da die Datei fehlt, sendet die Ereignisprozedur ein ioError-Ereignis.

Hinweise:

  • Für die Kompilierung der SWF-Datei müssen Sie die Option „Sicherheit bei lokaler Wiedergabe“ auf „Nur auf lokale Dateien zugreifen“ einstellen.
  • Auf der Ebene der SWF-Datei darf sich keine Datei mit dem Namen „MissingFile.xml“ befinden.

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

    public class IOErrorEventExample extends Sprite {
        public function IOErrorEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);

            var request:URLRequest = new URLRequest("MissingFile.xml");
            loader.load(request);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}




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