Referenshandbok för ActionScript® 3.0 i Adobe® Flash®-plattformen
Hem  |  Dölj paket och klasslista |  Paket  |  Klasser  |  Nyheter  |  Index  |  Bilagor  |  Varför på engelska?
Filter: Hämtar data från servern ...
Hämtar data från servern ...
Översta nivån 

Error  - AS3

PaketÖversta nivån
Klasspublic dynamic class Error
ArvError Inheritance Object
Underklasser 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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Klassen Error innehåller information om ett fel som inträffar i ett skript. När du under utvecklingsfasen av ActionScript 3.0-program kör kompilerad kod i felsökningsversionen av Flash-miljön, får du hjälp med att felsöka koden genom att undantag av typen Error eller av en underklass visas i en dialogruta. Du skapar ett Error-objekt med konstruktorfunktionen Error. Ett nytt Error-objekt genereras från ett try-kodblock och fångas upp av ett catch-kodblock.

Du kan också skapa en underklass av Error-klassen och generera instanser av den underklassen.

Visa exemplen



Publika egenskaper
 EgenskapDefinieras med
 Inheritedconstructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.
Object
  errorID : int
[skrivskyddad] Innehåller referensnumret som är associerat med det specifika felmeddelandet.
Error
  message : String
Innehåller meddelandet som är associerat med Error-objektet.
Error
  name : String
Innehåller namnet på Error-objektet.
Error
Publika metoder
 MetodDefinieras med
  
Error(message:String = "", id:int = 0)
Skapar ett nytt Error-objekt.
Error
  
Returnerar anropsstacken för ett fel när felet byggs upp som en sträng.
Error
 Inherited
Anger om det finns en egenskap angiven för ett objekt.
Object
 Inherited
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.
Object
 Inherited
Anger om den angivna egenskapen finns och är uppräkningsbar.
Object
 Inherited
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.
Object
 Inherited
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.
Object
  
[åsidosätt] Returnerar strängen ”Error” som standard eller det värde som finns i egenskapen Error.message, om den har definierats.
Error
 Inherited
Returnerar det angivna objektets primitiva värde.
Object
Egenskapsdetaljer

errorID

egenskap
errorID:int  [skrivskyddad]

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Innehåller referensnumret som är associerat med det specifika felmeddelandet. Numret är värdet från parametern id som anges i konstruktorn för ett anpassat Error-objekt.



Implementering
    public function get errorID():int

message

egenskap 
public var message:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Innehåller meddelandet som är associerat med Error-objektet. Som standard är värdet för egenskapen " Error ". Du kan ange en message-egenskap när du skapar ett Error-objekt genom att skicka Error-strängen till konstruktorfunktionen Error.

Relaterade API-element

name

egenskap 
public var name:String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Innehåller namnet på Error-objektet. Som standard är värdet för egenskapen " Error ".

Relaterade API-element

Konstruktordetaljer

Error

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

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Skapar ett nytt Error-objekt. Om message har specificerats tilldelas dess värde till objektets Error.message-egenskap.

Parametrar
message:String (default = "") — En sträng som är associerad med Error-objektet. Detta är en valfri parameter.
 
id:int (default = 0) — Ett referensnummer som associeras med det specifika felmeddelandet.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

I följande exempel skapas ett nytt Error-objekt, err. Därefter tilldelas strängen "New Error Message" till objektet err med hjälp av konstruktorn Error().
var err:Error = new Error();
trace(err.toString());    // Error

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

getStackTrace

()metod
public function getStackTrace():String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar anropsstacken för ett fel när felet byggs upp som en sträng. Som framgår av nästa exempel är den första raden i returvärdet strängbeteckningen av undantagsobjektet följt av stackspårningselementen:

     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]
        

Föregående lista visar värdet för den här metoden när den anropas i en felsökningsversion av Flash Player eller kod som körs i ADL (AIR Debug Launcher). När koden körs i en släppt version av Flash Player eller i AIR, anges stackspårningen utan filsökvägen och radnummerinformation enligt följande exempel:

     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 AIR 11.4, och tidigare, och AIR 3.4, och tidigare, är stackspårning endast tillgänglig när koden körs i felsökningsversionen av Flash Player eller ADL (AIR Debug Launcher). I icke-felsökningsversioner av dessa miljöer returnerar anrop av den här metoden null.

Returnerar
String — En strängbeteckning för anropsstacken.

toString

()metod 
override public function toString():String

Språkversion: ActionScript 3.0
Körningsmiljöversioner: AIR 1.0, Flash Player 9, Flash Lite 4

Returnerar strängen "Error" som standard eller det värde som finns i egenskapen Error.message om den har definierats.

Returnerar
String — Felmeddelandet.

Relaterade API-element


Exempel  ( Så här använder du exemplet )

I följande exempel skapas ett nytt Error-objekt, err. Därefter tilldelas strängen "New Error Message" till objektet err med hjälp av konstruktorn Error(). Slutligen ställs egenskapen message in på "Another New Error Message" som skriver över "New Error Message".
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

Följande exempel använder klassen ErrorExample för att visa hur ett anpassat fel kan genereras. Detta visas i följande steg:
  1. En lokal variabel nullArray av typen Array deklareras. Observera dock att inget nytt Array-objekt skapas.
  2. Konstruktorn försöker att läsa in ett värde i den oinitierade arrayen med metoden push() i ett felhanteringskodsegment som fångar ett anpassat fel med klassen CustomError som utökar Error.
  3. När CustomError genereras fångar konstruktorn felet och genererar ett felmeddelande med programsatsen trace().
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 ]Varför på engelska?
Innehåll i Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen är på engelska

Det är inte alla delar av Referenshandbok för ActionScript 3.0 i Adobe Flash-plattformen som översätts till alla språk. Om ett språkelement inte översätts visas det på engelska. Klassen ga.controls.HelpBox översätts till exempel inte till något språk. I den svenska versionen av referenshandboken visas därför klassen ga.controls.HelpBox på engelska.