PaketOberste Ebene
Klassepublic dynamic class Error
VererbungError Inheritance Object
Unterklassen ArgumentError, DefinitionError, EvalError, IllegalOperationError, InvalidSWFError, IOError, MemoryError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, StackOverflowError, SyntaxError, TypeError, URIError, VerifyError, VideoError

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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 von Flash Player 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- oder finally-Codeblocks abgefangen werden kann.

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

Beispiele anzeigen

Siehe auch

Verwenden der Debugger-Version von Flash Player
Erstellen benutzerdefinierter Fehlerklassen
Reagieren auf Fehler- und Statusereignisse


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  errorID : int
[read-only] 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
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
Öffentliche Methoden
 MethodeDefiniert von
  
Error(message:String = "", id:int = 0)
Erstellt ein neues Error-Objekt.
Error
  
Gibt zum Zeitpunkt der Fehlerentstehung den Call-Stack für den Fehler als String zurück (nur bei der Debugger-Version des Flash Players).
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
  
Gibt in der Standardeinstellung den String "Error" oder, sofern angegeben, den in der Eigenschaft Error.message enthaltenen Wert zurück.
Error
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftsdetail
errorIDEigenschaft
errorID:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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
messageEigenschaft 
public var message:String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Siehe auch

nameEigenschaft 
public var name:String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

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.

Siehe auch


Beispiel

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
Methodendetail
getStackTrace()Methode
public function getStackTrace():String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt zum Zeitpunkt der Fehlerentstehung den Call-Stack für den Fehler als String zurück (nur bei der Debugger-Version des Flash Players). Wie im folgenden Beispiel ersichtlich, ist die erste Zeile des Rückgabewerts die Stringdarstellung des Ausnahmeobjekts, gefolgt von den Stack-Trace-Elementen:

  TypeError: null cannot be converted to an object
      at com.xyz.OrderEntry.retrieveData(OrderEntry.as:995)
      at com.xyz.OrderEntry.init(OrderEntry.as:200)
      at com.xyz.OrderEntry.$construct(OrderEntry.as:148)
     

Rückgabewerte
String — Eine Stringdarstellung des Call-Stack.
toString()Methode 
public override function toString():String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt standardmäßig den String "Error" oder gegebenenfalls den in der Eigenschaft Error.message enthaltenen Wert zurück.

Rückgabewerte
String — Die Fehlermeldung.

Siehe auch


Beispiel

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 die Eigenschaft message 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
Beispiele Verwendung von Beispielen
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);
    }
}




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/Error.html