ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
flash.events 

ErrorEvent  - AS3

Pakietflash.events
Klasapublic class ErrorEvent
DziedziczenieErrorEvent Inheritance TextEvent Inheritance Event Inheritance Object
Podklasy AsyncErrorEvent, AugmentedErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMDeviceGroupErrorEvent, DRMErrorEvent, DRMReturnVoucherErrorEvent, IOErrorEvent, RSLErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent, UncaughtErrorEvent

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.0, Flash Lite 4

Obiekty wywołują obiekty zdarzeń ErrorEvent, gdy operacja asynchroniczna kończy się niepowodzeniem z powodu błędu.

Klasa ErrorEvent definiuje tylko jeden typ zdarzenia error: ErrorEvent.ERROR. Klasa ErrorEvent jest również klasą bazową dla kilku innych klas zdarzeń błędów, w tym dla klas: AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SQLErrorEvent i UncaughtErrorEvent.

Aby wykrywać zdarzenia error, dla których nie zarejestrowano żadnych detektorów, można zarejestrować detektor zdarzenia uncaughtError (UncaughtErrorEvent.UNCAUGHT_ERROR).

Nieprzechwycony błąd powoduje także wyświetlenie okna dialogowego z informacją o zdarzeniu błędu, gdy treść działa w wersji programu Flash Player z debugerem lub w aplikacji AIR Debug Launcher (ADL).

Wyświetl przykłady

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
 Inheritedbubbles : Boolean
[tylko do odczytu] Określa, czy zdarzenie może przechodzić fazę propagacji.
Event
 Inheritedcancelable : Boolean
[tylko do odczytu] Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem.
Event
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
 InheritedcurrentTarget : Object
[tylko do odczytu] Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
Event
  errorID : int
[tylko do odczytu] Zawiera numer referencyjny skojarzony z konkretnym błędem.
ErrorEvent
 InheritedeventPhase : uint
[tylko do odczytu] Bieżąca faza przepływu zdarzeń.
Event
 Inheritedtarget : Object
[tylko do odczytu] Miejsce docelowe zdarzenia.
Event
 Inheritedtext : String
W przypadku zdarzenia textInput jest to znak lub sekwencja znaków wprowadzonych przez użytkownika.
TextEvent
 Inheritedtype : String
[tylko do odczytu] Typ zdarzenia.
Event
Metody publiczne
 MetodaZdefiniowane przez
  
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)
Tworzy obiekt Event, który zawiera informacje o zdarzeniach błędów.
ErrorEvent
  
[przesłanianie] Tworzy kopię obiektu ErrorEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.
ErrorEvent
 Inherited
formatToString(className:String, ... arguments):String
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0.
Event
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault().
Event
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane.
Event
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim.
Event
 Inherited
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń.
Event
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
  
[przesłanianie] Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu ErrorEvent.
ErrorEvent
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
Stałe publiczne
 StałaZdefiniowane przez
  ERROR : String = "error"
[statyczny] Definiuje wartość właściwości type obiektu zdarzenia error.
ErrorEvent
Szczegół właściwości

errorID

właściwość
errorID:int  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 10.1

Zawiera numer referencyjny skojarzony z konkretnym błędem. W przypadku niestandardowego obiektu ErrorEvent ta liczba jest wartością parametru id przekazanego w konstruktorze.



Implementacja
    public function get errorID():int
Konstruktor Szczegół

ErrorEvent

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

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.0, Flash Lite 4

Tworzy obiekt Event, który zawiera informacje o zdarzeniach błędów. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.

Parametry
type:String — Typ zdarzenia. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości type. Istnieje tylko jeden typ zdarzenia błędu: ErrorEvent.ERROR.
 
bubbles:Boolean (default = false) — Określa, czy obiekt Event jest w fazie propagacji. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości bubbles.
 
cancelable:Boolean (default = false) — Określa, czy obiekt Event może zostać anulowany. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości cancelable.
 
text:String (default = "") — Tekst, który ma być wyświetlany w charakterze komunikatu o błędzie. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem właściwości text.
 
id:int (default = 0) — Numer referencyjny skojarzony z konkretnym błędem (obsługiwany tylko w środowisku Adobe AIR).
Szczegół metody

clone

()metoda
override public function clone():Event

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.0, Flash Lite 4

Tworzy kopię obiektu ErrorEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.

Zwraca
Event — Nowy obiekt ErrorEvent z wartościami właściwości zgodnymi z oryginałem.

toString

()metoda 
override public function toString():String

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.0, Flash Lite 4

Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu ErrorEvent. Format ciągu znaków jest następujący:

[ErrorEvent type=wartość bubbles=wartość cancelable=wartość text=wartość errorID=wartość]

Uwaga: Wartość errorId zwrócona przez metodę toString() jest dostępna jedynie w środowisku Adobe AIR. Chociaż program Flash Player 10.1 obsługuje właściwość errorID, wywołanie metody toString() dla obiektu ErrorEvent nie spowoduje zwrócenia wartości errorId w programie Flash Player.

Zwraca
String — Ciąg znaków, który zawiera wszystkie właściwości obiektu ErrorEvent.
Szczegół stałej

ERROR

Stała
public static const ERROR:String = "error"

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.0, Flash Lite 4

Definiuje wartość właściwości type obiektu zdarzenia error.

To zdarzenie ma następujące właściwości:

WłaściwośćWartość
bubblesfalse
cancelablefalse; nie ma domyślnego zachowania, które można byłoby anulować.
currentTargetObiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
targetObiekt, w którym wystąpiło niepowodzenie operacji sieciowej.
textTekst, który ma być wyświetlany w charakterze komunikatu o błędzie.

ErrorEventExample.as

Poniższy przykład demonstruje użycie pojedynczej procedury obsługi błędu (errorHandler()), która przechwytuje wiele typów błędów. Jeśli wystąpi zdarzenie ioError, procedura próbuje załadować plik z sieci, co z kolei powoduje wygenerowanie zdarzenia securityError.

Uwaga: Przykład nie będzie działał, jeśli w tym samym katalogu, co plik SWF, istnieje plik o nazwie MissingFile.xml.

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 ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.