Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Error
. Normaal gesproken gebruikt u een nieuw Error-object vanuit een codeblok try
dat wordt afgevangen door een codeblok catch
.
U kunt ook een subklasse van de klasse Error maken en instanties uit die subklasse genereren.
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
errorID : int [alleen-lezen]
Bevat het referentienummer dat aan het specifieke foutbericht is gekoppeld. | Error | ||
message : String
Bevat het bericht dat aan het object Error is gekoppeld. | Error | ||
name : String
Bevat de naam van het object Error. | Error |
Methode | Gedefinieerd door | ||
---|---|---|---|
Maakt een nieuw object Error. | Error | ||
Retourneert de aanroepstack voor een fout op het moment van het bouwen van de fout als tekenreeks. | Error | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
[overschrijven]
Retourneert standaard de tekenreeks "Error" of de waarde in de eigenschap Error.message, indien gedefinieerd. | Error | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
errorID | eigenschap |
errorID:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bevat het referentienummer dat aan het specifieke foutbericht is gekoppeld. Voor een aangepast object Error is dit nummer de waarde van de parameter id
die in de constructor wordt opgegeven.
Implementatie
public function get errorID():int
message | eigenschap |
public var message:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bevat het bericht dat aan het object Error is gekoppeld. De standaardwaarde van deze eigenschap is "Error
". U kunt een eigenschap message
opgeven wanneer u een object Error maakt door de fouttekenreeks aan de constructorfunctie Error
door te geven.
Verwante API-elementen
name | eigenschap |
public var name:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Bevat de naam van het object Error. De standaardwaarde van deze eigenschap is "Error
".
Verwante API-elementen
Error | () | Constructor |
public function Error(message:String = "", id:int = 0)
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Maakt een nieuw object Error. Wanneer message
wordt opgegeven, wordt de waarde ervan toegewezen aan de eigenschap Error.message
van het object.
message:String (default = " ") — Een tekenreeks die aan het object Error is gekoppeld; deze parameter is optioneel.
| |
id:int (default = 0 ) — Een referentienummer dat aan het specifieke foutbericht is gekoppeld.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
err
gemaakt. Vervolgens wordt met de constructor Error()
de tekenreeks "New Error Message"
aan err
toegewezen.
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
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert de aanroepstack voor een fout op het moment van het bouwen van de fout als tekenreeks. Zoals in het volgende voorbeeld wordt getoond, is de eerste regel van de geretourneerde waarde de tekenreeksrepresentatie van het uitzonderingsobject, gevolgd door de stacktraceringselementen:
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]
Het voorgaande voorbeeld toont de waarde van deze methode als deze wordt aangeroepen in een foutopsporingsversie van Flash Player of code die in de AIR Debug Launcher (ADL) wordt uitgevoerd. Wanneer de code in een releaseversie van Flash Player of AIR wordt uitgevoerd, wordt de stacktracering opgegeven zonder het bestandspad en regelnummerinformatie, zoals in het volgende voorbeeld:
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()
Voor Flash Player 11.4 en lager en AIR 3.4 en lager, zijn stacktraceringen alleen beschikbaar wanneer de code wordt uitgevoerd in de foutopsporingsversie van Flash Player of de AIR Debug Launcher (ADL). In niet-foutopsporingsversies van deze runtimes wordt null
geretourneerd wanneer deze methode wordt aangeroepen.
String — Een tekenreeksrepresentatie van de aanroepstack.
|
toString | () | methode |
override public function toString():String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retourneert standaard de tekenreeks "Error"
of de waarde in de eigenschap Error.message
, indien gedefinieerd.
String — Het foutbericht.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
err
gemaakt. Vervolgens wordt met de constructor Error()
de tekenreeks "New Error Message"
aan err
toegewezen. Uiteindelijk wordt de eigenschap message
ingesteld op "Another New Error Message"
en wordt "New Error Message"
overschreven.
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
gebruikt om te tonen hoe een aangepaste fout kan worden gegenereerd. Dit wordt gedaan door de volgende stappen te volgen:
- Een lokale variabele
nullArray
van het type Array wordt gedeclareerd, maar er wordt geen nieuw object Array gemaakt. - De constructor probeert een waarde te laden in de niet-geïnitialiseerde array door de methode
push()
te gebruiken binnen een foutverwerkingscodesegment dat een aangepaste fout vangt met behulp van de klasseCustomError
, dieError
uitbreidt. - Wanneer CustomError wordt gegenereerd, wordt deze door de constructor afgevangen en een foutbericht uitgevoerd door de instructie
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); } }
Wed Jun 13 2018, 11:42 AM Z