Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Error
. Di solito, un nuovo oggetto Error viene generato dall’interno di un blocco di codice try
, che viene rilevato da un blocco di codice catch
.
Potete anche creare una sottoclasse della classe Error e generare delle istanze di tale sottoclasse.
Altri esempi
Utilizzo delle istruzioni try..catch..finally
Creazione di classi di errore personalizzate
Risposte a eventi errore e a errori basati sullo stato
Esempio di gestione degli errori: applicazione CustomErrors
Altre informazioni
Gestione degli errori in ActionScript 3.0
Elementi utilizzati da ActionScript 3.0 per la gestione degli errori
Strategie di gestione degli errori
Confronto tra le classi di tipo Error
Classi Error di base
Proprietà | Definito da | ||
---|---|---|---|
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
errorID : int [sola lettura]
Contiene il numero di riferimento associato al messaggio di errore specifico. | Error | ||
message : String
Contiene il messaggio associato all'oggetto Error. | Error | ||
name : String
Contiene il nome dell'oggetto Error. | Error |
Metodo | Definito da | ||
---|---|---|---|
Crea un nuovo oggetto Error. | Error | ||
Restituisce lo stack di chiamata per un errore al momento della costruzione dell’errore come stringa. | Error | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
[override]
Restituisce la stringa "Error" per impostazione predefinita oppure il valore contenuto nella proprietà Error.message, se definita. | Error | ||
Restituisce il valore di base dell'oggetto specificato. | Object |
errorID | proprietà |
errorID:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Contiene il numero di riferimento associato al messaggio di errore specifico. Per un oggetto Error personalizzato, questo numero è il valore tratto dal parametro id
fornito nella funzione di costruzione.
Implementazione
public function get errorID():int
message | proprietà |
public var message:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Contiene il messaggio associato all'oggetto Error. Per impostazione predefinita, il valore di questa proprietà è "Error
". Potete specificare una proprietà message
quando create un oggetto Error passando la stringa di errore alla funzione di costruzione Error
.
Elementi API correlati
name | proprietà |
public var name:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Contiene il nome dell'oggetto Error. Per impostazione predefinita, il valore di questa proprietà è "Error
".
Elementi API correlati
Error | () | Funzione di costruzione |
public function Error(message:String = "", id:int = 0)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un nuovo oggetto Error. Se il parametro message
è specificato, il suo valore viene assegnato alla proprietà Error.message
dell'oggetto.
message:String (default = " ") — Una stringa associata all'oggetto Error; questo parametro è opzionale.
| |
id:int (default = 0 ) — Un numero di riferimento da associare al messaggio di errore specifico.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
err
e quindi, mediante la funzione di costruzione Error()
, come assegnare la stringa "New Error Message"
a err
.
var err:Error = new Error(); trace(err.toString()); // Error err = new Error("New Error Message"); trace(err.toString()); // Error: New Error Message
getStackTrace | () | metodo |
public function getStackTrace():String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce lo stack di chiamata per un errore al momento della costruzione dell’errore come stringa. Come mostrato nell’esempio seguente, la prima riga del valore restituito è la rappresentazione in formato stringa dell’oggetto eccezione, seguito dagli elementi trace dello stack:
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]
L’elenco precedente mostra il valore di questo metodo quando viene chiamato in una versione di debug di Flash Player o in un codice eseguito in AIR Debug Launcher (ADL). Quando il codice viene eseguito in una versione release di Flash Player o di AIR, la traccia dello stack viene fornita senza il percorso del file e senza numeri di riga, come nell’esempio seguente:
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()
Per Flash Player 11.4 e versioni precedenti e per AIR 3.4 e versioni precedenti, le tracce di stack sono disponibili solo quando l’esecuzione del codice avviene nella versione debug di Flash Player o in AIR Debug Launcher (ADL). Nelle versioni non di debug di questi runtime, la chiamata di questo metodo restituiscenull
.
String — Una rappresentazione in formato stringa dello stack di chiamata.
|
toString | () | metodo |
override public function toString():String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce la stringa "Error"
per impostazione predefinita oppure il valore contenuto nella proprietà Error.message
, se definita.
String — Il messaggio di errore.
|
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
err
e quindi, mediante la funzione di costruzione Error()
, come assegnare la stringa "New Error Message"
a err
. Infine, la proprietà message
viene impostata su "Another New Error Message"
per sovrascrivere "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
per mostrare come è possibile generare un errore personalizzato. Questa operazione viene eseguita mediante la procedura seguente:
- Viene dichiarata una variabile locale
nullArray
di tipo Array, ma non viene creato un nuovo oggetto Array. - La funzione di costruzione tenta di caricare un valore nell'array non inizializzato utilizzando il metodo
push()
all'interno di un segmento di codice per la gestione degli errori che rileva un errore personalizzato mediante la classeCustomError
, che estendeError
. - Quando viene generata la classe CustomError, la funzione di costruzione la rileva e crea un messaggio di errore mediante l'istruzione
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); } }
Tue Jun 12 2018, 02:44 PM Z