Log - Adobe ActionScript® 3 (AS3 Flex) API 參考

套件	mx.logging
類別	public class Log
繼承	Log Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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.

更多範例

Using the logging API

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		addTarget(target:mx.logging:ILoggingTarget):void [靜態] Allows the specified target to begin receiving notification of log events.	Log
		flush():void [靜態] This method removes all of the current loggers from the cache.	Log
		getLogger(category:String):ILogger [靜態] Returns the logger associated with the specified category.	Log
		hasIllegalCharacters(value:String):Boolean [靜態] This method checks the specified string value for illegal characters.	Log
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isDebug():Boolean [靜態] Indicates whether a debug level log event will be processed by a log target.	Log
		isError():Boolean [靜態] Indicates whether an error level log event will be processed by a log target.	Log
		isFatal():Boolean [靜態] Indicates whether a fatal level log event will be processed by a log target.	Log
		isInfo():Boolean [靜態] Indicates whether an info level log event will be processed by a log target.	Log
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		isWarn():Boolean [靜態] Indicates whether a warn level log event will be processed by a log target.	Log
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		removeTarget(target:mx.logging:ILoggingTarget):void [靜態] Stops the specified target from receiving notification of log events.	Log
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object

方法詳細資訊

addTarget

()

方法

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

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

參數

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

flush

()

方法

public static function flush():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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

()

方法

public static function getLogger(category:String):ILogger

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

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.

參數

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

傳回值

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

()

方法

public static function hasIllegalCharacters(value:String):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

This method checks the specified string value for illegal characters.

參數

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

傳回值

Boolean — true if there are any illegal characters found, false otherwise

isDebug

()

方法

public static function isDebug():Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

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

傳回值

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

isError

()

方法

public static function isError():Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

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

傳回值

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

isFatal

()

方法

public static function isFatal():Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

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

傳回值

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

isInfo

()

方法

public static function isInfo():Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

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

傳回值

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

isWarn

()

方法

public static function isWarn():Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

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

傳回值

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

removeTarget

()

方法

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

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Stops the specified target from receiving notification of log events.

參數

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

法律聲明 | 線上隱私權政策

Log - AS3 Flex

類別 x

addTarget

flush

getLogger

hasIllegalCharacters

isDebug

isError

isFatal

isInfo

isWarn

removeTarget