Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : 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 |
Methode | Definiert von | ||
---|---|---|---|
Erstellt ein neues Error-Objekt. | Error | ||
Gibt den Aufrufstapel für einen Fehler zum Zeitpunkt der Fehlerentstehung als String zurück. | Error | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
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 | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
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
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.
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 )
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
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.
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.
String — Die Fehlermeldung.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
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
-Klasse gezeigt, wie ein benutzerdefinierter Fehler erzeugt werden kann. Dies wird in den folgenden Schritten erreicht:
- Eine lokale Variable
nullArray
vom Typ Array wird zwar deklariert, es muss jedoch beachten werden, dass kein neues Array-Objekt erstellt wird. - 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 derCustomError
-Klasse abgefangen undError
erweitert wird. - 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); } }
Tue Jun 12 2018, 10:04 AM Z