Error

Paket	Översta nivån
Klass	public dynamic class Error
Arv	Error 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

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		constructor : 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

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		Error(message:String = "", id:int = 0) Skapar ett nytt Error-objekt.	Error
		getStackTrace():String Returnerar anropsstacken för ett fel när felet byggs upp som en sträng.	Error
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String [åsidosätt] Returnerar strängen ”Error” som standard eller det värde som finns i egenskapen Error.message, om den har definierats.	Error
		valueOf():Object 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

statements.html#throw
statements.html#try..catch..finally

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

statements.html#throw
statements.html#try..catch..finally

Konstruktordetaljer

()

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

statements.html#throw
statements.html#try..catch..finally

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

Error.message
statements.html#throw
statements.html#try..catch..finally

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

Exempel Så här använder du exemplet

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:

En lokal variabel nullArray av typen Array deklareras. Observera dock att inget nytt Array-objekt skapas.
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.
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);
    }
}

Juridiska meddelanden | Onlinesekretesspolicy

Error - AS3

Klasser x

errorID

message

name

Error

getStackTrace

toString