Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
mx.logging 

Log  - AS3 Flex

Pacchettomx.logging
Classepublic class Log
EreditarietàLog Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Provides pseudo-hierarchical logging capabilities with multiple format and output options. The log system consists of two major components, the logger and a target. You can use the logger to send information to a target. The target is responsible for formatting and general output of the log data.

Loggers are singleton instances created for a particular category of information. Typically, the category is the package name of the component that desires to log information. The category provides users the ability to specify what log information they are interested in. Multiple categories can be selected and combined with regular expressions. This allows for both broad and narrow logging information to be acquired. For example, you might be interested in all logging information under the "mx.messaging" and "mx.rpc" packages and want the output from these packages to be formatted as XML. To get the all of the logging information under the "mx.messaging" category including sub-packages and components a wildcard expression is required, such as "mx.messaging.*". See the code example below for more details.

Targets provide the output mechanism of the data being logged. This mechanism typically includes formatting, transmission, or storage, but can be anything possible under the VM. There are two targets provided: MiniDebugTarget and TraceTarget. Each of these writers take the current log information and "sends" it somewhere for display and/or storage. Targets also provide the specification of what log data to output.

Altri esempi



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
Metodi pubblici
 MetodoDefinito da
  
[statico] Allows the specified target to begin receiving notification of log events.
Log
  
[statico] This method removes all of the current loggers from the cache.
Log
  
[statico] Returns the logger associated with the specified category.
Log
  
[statico] This method checks the specified string value for illegal characters.
Log
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
  
[statico] Indicates whether a debug level log event will be processed by a log target.
Log
  
[statico] Indicates whether an error level log event will be processed by a log target.
Log
  
[statico] Indicates whether a fatal level log event will be processed by a log target.
Log
  
[statico] Indicates whether an info level log event will be processed by a log target.
Log
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
  
[statico] Indicates whether a warn level log event will be processed by a log target.
Log
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
  
[statico] Stops the specified target from receiving notification of log events.
Log
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione dei metodi

addTarget

()metodo
public static function addTarget(target:mx.logging:ILoggingTarget):void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Allows the specified target to begin receiving notification of log events.

Parametri

target:mx.logging:ILoggingTarget — specific target that should capture log events.

flush

()metodo 
public static function flush():void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

This method removes all of the current loggers from the cache. Subsquent calls to the getLogger() method return new instances of loggers rather than any previous instances with the same category. This method is intended for use in debugging only.

getLogger

()metodo 
public static function getLogger(category:String):ILogger

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Returns the logger associated with the specified category. If the category given doesn't exist a new instance of a logger will be returned and associated with that category. Categories must be at least one character in length and may not contain any blanks or any of the following characters: []~$^&\/(){}<>+=`!#%?,:;'"@ This method will throw an InvalidCategoryError if the category specified is malformed.

Parametri

category:String — The category of the logger that should be returned.

Restituisce
ILogger — An instance of a logger object for the specified name. If the name doesn't exist, a new instance with the specified name is returned.

hasIllegalCharacters

()metodo 
public static function hasIllegalCharacters(value:String):Boolean

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

This method checks the specified string value for illegal characters.

Parametri

value:String — The String to check for illegal characters. The following characters are not valid: []~$^&\/(){}<>+=`!#%?,:;'"@

Restituisce
Booleantrue if there are any illegal characters found, false otherwise

isDebug

()metodo 
public static function isDebug():Boolean

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Indicates whether a debug level log event will be processed by a log target.

Restituisce
Boolean — true if a debug level log event will be logged; otherwise false.

isError

()metodo 
public static function isError():Boolean

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Indicates whether an error level log event will be processed by a log target.

Restituisce
Boolean — true if an error level log event will be logged; otherwise false.

isFatal

()metodo 
public static function isFatal():Boolean

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Indicates whether a fatal level log event will be processed by a log target.

Restituisce
Boolean — true if a fatal level log event will be logged; otherwise false.

isInfo

()metodo 
public static function isInfo():Boolean

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Indicates whether an info level log event will be processed by a log target.

Restituisce
Boolean — true if an info level log event will be logged; otherwise false.

isWarn

()metodo 
public static function isWarn():Boolean

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Indicates whether a warn level log event will be processed by a log target.

Restituisce
Boolean — true if a warn level log event will be logged; otherwise false.

removeTarget

()metodo 
public static function removeTarget(target:mx.logging:ILoggingTarget):void

Versione linguaggio: ActionScript 3.0
Versione prodotto: Flex 3
Versioni runtime: Flash Player 9, AIR 1.1

Stops the specified target from receiving notification of log events.

Parametri

target:mx.logging:ILoggingTarget — specific target that should capture log events.





[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.