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...
Oberste Ebene 

Error  - AS3

PaketOberste Ebene
Klassepublic dynamic class Error
VererbungError Inheritance Object
Unterklassen ArgumentError, AugmentedError, AutomationError, CollectionViewError, ComplexCyclicDependencyError, Conflict, ConstraintError, CursorError, DataServiceError, DefinitionError, DRMManagerError, EvalError, ExpressionError, ExpressionEvaluationError, ExpressionValidationError, Fault, FormBridgeError, FunctionSequenceError, IllegalOperationError, InvalidCategoryError, InvalidFilterError, InvalidSWFError, IOError, ItemPendingError, MediaError, MemoryError, MessagingError, MetricError, NoDataAvailableError, PermissionError, PersistenceError, PersistenceError, ProxyServiceError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, SimpleCyclicDependencyError, SortError, SQLError, StackOverflowError, SyncManagerError, SyntaxError, TypeError, UnresolvedConflictsError, URIError, VerifyError, VideoError, VideoError

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

Die Error-Klasse enthält Informationen zu einem Fehler in Ihrem Skript. Wenn Sie ActionScript 3.0-Anwendungen entwickeln und Ihren kompilierten Programmcode in der Debugger-Version einer Flash-Laufzeitumgebung ausführen, werden in einem speziellen Dialogfeld Ausnahmen vom Typ Error angezeigt, oder von einer Unterklasse. Dadurch wird Ihnen die Fehlersuche im Code erleichtert. Ein Error-Objekt wird mit der Konstruktorfunktion Error erstellt. Gewöhnlich lösen Sie in einem try-Codeblock ein neues Error-Objekt aus, das mithilfe einescatch-Codeblocks abgefangen werden kann.

Sie können auch eine Unterklasse der Error-Klasse erstellen und Instanzen dieser Unterklasse ausgeben.

Beispiele anzeigen



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  errorID : int
[schreibgeschützt] Enthält die Verweisnummer der zugeordneten Fehlermeldung.
Error
  message : String
Enthält die mit dem Error-Objekt verbundene Meldung.
Error
  name : String
Enthält den Namen des Error-Objekts.
Error
Öffentliche Methoden
 MethodeDefiniert von
  
Error(message:String = "", id:int = 0)
Erstellt ein neues Error-Objekt.
Error
  
Gibt den Aufrufstapel für einen Fehler zum Zeitpunkt der Fehlerentstehung als String zurück.
Error
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 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
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
[override] Gibt in der Standardeinstellung den String „Error“ oder, sofern definiert, den in der Error.message-Eigenschaft enthaltenen Wert zurück.
Error
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

errorID

Eigenschaft
errorID:int  [schreibgeschützt]

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

Enthält die Verweisnummer der zugeordneten Fehlermeldung. Bei einem selbst definierten Error-Objekt entspricht diese Nummer dem Wert des im Konstruktor bereitgestellten id-Parameters.



Implementierung
    public function get errorID():int

message

Eigenschaft 
public var message:String

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

Enthält die mit dem Error-Objekt verbundene Meldung. Der Standardwert dieser Eigenschaft lautet "Error". Sie können eine message-Eigenschaft angeben, wenn Sie ein neues Error-Objekt erstellen, indem Sie den Fehlerstring an die Error-Konstruktorfunktion übergeben.

Verwandte API-Elemente

name

Eigenschaft 
public var name:String

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

Enthält den Namen des Error-Objekts. Der Standardwert dieser Eigenschaft lautet "Error".

Verwandte API-Elemente

Konstruktordetails

Error

()Konstruktor
public function Error(message:String = "", id:int = 0)

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

Erstellt ein neues Error-Objekt. Wenn message angegeben ist, wird dieser Wert der Eigenschaft Error.message des Objekts zugewiesen.

Parameter
message:String (default = "") — Ein String, der mit dem Error-Objekt verknüpft ist. Dieser Parameter ist optional.
 
id:int (default = 0) — Enthält die Verweisnummer der zugeordneten Fehlermeldung.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein neues Error-Objekt err erstellt. Anschließend wird mithilfe des Error()-Konstruktors der String "New Error Message" dem Error-Objekt err zugewiesen.
var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message
Methodendetails

getStackTrace

()Methode
public function getStackTrace():String

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

Gibt den Aufrufstapel für einen Fehler zum Zeitpunkt der Fehlerentstehung als String zurück. Wie im folgenden Beispiel ersichtlich, ist die erste Zeile des Rückgabewerts die Stringdarstellung des Ausnahmeobjekts, gefolgt von den Stack-Trace-Elementen:

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()[/src/com/xyz/OrderEntry.as:995]
         at com.xyz::OrderEntry/init()[/src/com/xyz/OrderEntry.as:200]
         at com.xyz::OrderEntry()[/src/com/xyz/OrderEntry.as:148]
        

Die vorherige Auflistung zeigt den Wert dieser Methode, wenn sie in einer Debugger-Version von Flash Player aufgerufen wird oder in Code, der im AIR Debug Launcher (ADL) ausgeführt wird. Wenn der Code in einer Releaseversion von Flash Player oder AIR ausgeführt wird, wird der Stacktrace ohne die Informationen zu Dateipfad und Zeilennummer bereitgestellt, wie in folgendem Beispiel:

     TypeError: Error #1009: Cannot access a property or method of a null object reference
         at com.xyz::OrderEntry/retrieveData()
         at com.xyz::OrderEntry/init()
         at com.xyz::OrderEntry()
        

Für Flash Player 11.4 und früher sowie AIR 3.4 und früher sind Stacktraces nur verfügbar, wenn Code in der Debugger-Version von Flash Player oder im AIR Debug Launcher (ADL) ausgeführt wird. In Nicht-Debugger-Versionen dieser Laufzeitumgebungen gibt der Aufruf dieser Methode null zurück.

Rückgabewerte
String — Eine Stringdarstellung des Call-Stack.

toString

()Methode 
override public function toString():String

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

Gibt in der Standardeinstellung den String "Error" oder, sofern definiert, den in der Error.message-Eigenschaft enthaltenen Wert zurück.

Rückgabewerte
String — Die Fehlermeldung.

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein neues Error-Objekt err erstellt. Anschließend wird mithilfe des Error()-Konstruktors der String "New Error Message" dem Error-Objekt err zugewiesen. Abschließend wird die message-Eigenschaft auf "Another New Error Message" gesetzt, womit "New Error Message" überschrieben wird.
var err:Error = new Error();
trace(err.toString());    // Error

err = new Error("New Error Message");
trace(err.toString());    // Error: New Error Message

err.message = "Another New Error Message";
trace(err.toString());    // Error: Another New Error Message
ErrorExample.as

Im folgenden Beispiel wird mithilfe der ErrorExample-Klasse gezeigt, wie ein benutzerdefinierter Fehler erzeugt werden kann. Dies wird in den folgenden Schritten erreicht:
  1. Eine lokale Variable nullArray vom Typ Array wird zwar deklariert, es muss jedoch beachten werden, dass kein neues Array-Objekt erstellt wird.
  2. Der Konstruktor versucht mithilfe der push()-Methode einen Wert in das nicht initialisierte Array zu laden. Diese Methode befindet sich in einem Codesegment zur Fehlerverarbeitung, mit dem ein benutzerdefinierter Fehler mithilfe der CustomError-Klasse abgefangen und Error erweitert wird.
  3. Wenn ein benutzerdefinierter Fehler ausgelöst wird, wird er vom Konstruktor abgefangen. Anschließend gibt er eine Fehlermeldung mithilfe der trace()-Anweisung aus.
package
{
    import flash.display.Sprite;
    public class ErrorExample extends Sprite 
    {
        private var nullArray:Array;
        public function ErrorExample() 
        {
            try 
            {
                nullArray.push("item");
            }
            catch(e:Error) 
            {
                throw new CustomError("nullArray is null");
            }
        }
    }
}

class CustomError extends Error 
{
    public function CustomError(message:String) 
    {
        super(message);
    }
}




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