PacchettoPrimo livello
Classepublic dynamic class Error
EreditarietàError Inheritance Object
Sottoclassi ArgumentError, DefinitionError, EvalError, IllegalOperationError, InvalidSWFError, IOError, MemoryError, RangeError, ReferenceError, ScriptTimeoutError, SecurityError, StackOverflowError, SyntaxError, TypeError, URIError, VerifyError, VideoError

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe Error contiene informazioni su un errore che si è verificato in uno script. Durante lo sviluppo di applicazioni ActionScript 3.0, quando si esegue un codice compilato nella versione debugger di Flash Player, una finestra di dialogo mostra le eccezioni di tipo Error o di una sottoclasse, per facilitare la risoluzione degli eventuali problemi del codice. È possibile creare un oggetto Error mediante la funzione di costruzione 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 o finally.

È anche possibile creare una sottoclasse della classe Error e generare delle istanze di tale sottoclasse.

Vedere gli esempi

Vedere anche

Utilizzo della versione debugger di Flash Player
Creazione di classi di errore personalizzate
Risposte a eventi errore e a errori basati sullo stato


Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor: 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
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
Metodi pubblici
 MetodoDefinito da
  
Error(message:String = "", id:int = 0)
Crea un nuovo oggetto Error.
Error
  
Restituisce lo stack di chiamata di un errore sotto forma di stringa al momento della creazione dell'errore (solo per la versione debugger di Flash Player).
Error
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
  
Restituisce la stringa "Error" per impostazione predefinita oppure il valore contenuto nella proprietà Error.message, se definita.
Error
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà
errorIDproprietà
errorID:int  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

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

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Contiene il messaggio associato all'oggetto Error. Per impostazione predefinita, il valore di questa proprietà è "Error". È possibile specificare una proprietà message quando si crea un oggetto Error passando la stringa di errore alla funzione di costruzione Error.

Vedere anche

nameproprietà 
public var name:String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Contiene il nome dell'oggetto Error. Per impostazione predefinita, il valore di questa proprietà è "Error".

Vedere anche

Descrizione della funzione di costruzione
Error()Funzione di costruzione
public function Error(message:String = "", id:int = 0)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un nuovo oggetto Error. Se il parametro message è specificato, il suo valore viene assegnato alla proprietà Error.message dell'oggetto.

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

Vedere anche


Esempio

Nell'esempio seguente viene illustrato come creare un nuovo oggetto Error 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
Descrizione dei metodi
getStackTrace()metodo
public function getStackTrace():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce lo stack di chiamata di un errore sotto forma di stringa al momento della creazione dell'errore (solo per la versione debugger di Flash Player). 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: 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)
     

Restituisce
String — Una rappresentazione in formato stringa dello stack di chiamata.
toString()metodo 
public override function toString():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce la stringa "Error" per impostazione predefinita oppure il valore contenuto nella proprietà Error.message, se definito.

Restituisce
String — Il messaggio di errore.

Vedere anche


Esempio

Nell'esempio seguente viene illustrato come creare un nuovo oggetto Error 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
Esempi Come utilizzare gli esempi
ErrorExample.as

L'esempio seguente utilizza la classe ErrorExample per mostrare come è possibile generare un errore personalizzato. Questa operazione viene eseguita mediante la procedura seguente:
  1. Viene dichiarata una variabile locale nullArray di tipo Array, ma non viene creato un nuovo oggetto Array.
  2. 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 classe CustomError, che estende Error.
  3. 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);
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/Error.html