用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
mx.logging 

ILogger  - AS3 Flex

mx.logging
接口public interface ILogger extends IEventDispatcher
实现器 LogLogger

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

日志记录框架中的所有记录器都必须实现此接口。



公共属性
 属性由以下参数定义
  category : String
[只读] 记录器的类别值。
ILogger
公共方法
 方法由以下参数定义
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
IEventDispatcher
  
debug(message:String, ... rest):void
使用 LogEventLevel.DEBUG 级别记录指定的数据。
ILogger
 Inherited
将事件调度到事件流中。
IEventDispatcher
  
error(message:String, ... rest):void
使用 LogEventLevel.ERROR 级别记录指定的数据。
ILogger
  
fatal(message:String, ... rest):void
使用 LogEventLevel.FATAL 级别记录指定的数据。
ILogger
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
IEventDispatcher
  
info(message:String, ... rest):void
使用 LogEvent.INFO 级别记录指定的数据。
ILogger
  
log(level:int, message:String, ... rest):void
在给定级别记录指定数据。
ILogger
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
IEventDispatcher
  
warn(message:String, ... rest):void
使用 LogEventLevel.WARN 级别记录指定的数据。
ILogger
 Inherited
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。
IEventDispatcher
属性详细信息

category

属性
category:String  [只读]

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

记录器的类别值。



实现
    public function get category():String
方法详细信息

debug

()方法
public function debug(message:String, ... rest):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

使用 LogEventLevel.DEBUG 级别记录指定的数据。LogEventLevel.DEBUG,指示对调试应用程序大有帮助的细粒度级别的信息性消息。

为日志记录指定的字符串可以包含使用括号括起来的索引,用于指示在记录字符串之前应该插入哪个附加参数。例如,当使用 10 和 15 作为参数进行调用时,“第一个附加参数是 {0},第二个附加参数是 {1}”将转化为“第一个附加参数是 10,第二个附加参数是 15”。

参数

message:String — 要记录的信息。此字符串可以包含 {x} 形式的特殊标记字符,其中 x 是从零开始的索引,将由在该索引位置找到的附加参数取代(如果已指定)。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数,其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用本示例
      // Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.debug("here is some channel info {0} and {1}", 15.4, true);
     
      // This will log the following String:
      //   "here is some channel info 15.4 and true"
      

error

()方法 
public function error(message:String, ... rest):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

使用 LogEventLevel.ERROR 级别记录指定的数据。LogEventLevel.ERROR,指示可能仍然允许应用程序继续运行的错误事件。

为日志记录指定的字符串可以包含使用括号括起来的索引,用于指示在记录字符串之前应该插入哪个附加参数。例如,当使用 10 和 15 作为参数进行调用时,“第一个附加参数是 {0},第二个附加参数是 {1}”将转化为“第一个附加参数是 10,第二个附加参数是 15”。

参数

message:String — 要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符,其中 x 是从零开始的索引,将由在该索引位置找到的附加参数取代(如果已指定)。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数,其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用本示例
      // Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.error("here is some channel info {0} and {1}", 15.4, true);
     
      // This will log the following String:
      //   "here is some channel info 15.4 and true"
      

fatal

()方法 
public function fatal(message:String, ... rest):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

使用 LogEventLevel.FATAL 级别记录指定的数据。LogEventLevel.FATAL,指示负面影响严重且最终会导致应用程序失败的事件

为日志记录指定的字符串可以包含使用括号括起来的索引,用于指示在记录字符串之前应该插入哪个附加参数。例如,当使用 10 和 15 作为参数进行调用时,“第一个附加参数是 {0},第二个附加参数是 {1}”将转化为“第一个附加参数是 10,第二个附加参数是 15”。

参数

message:String — 要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符,其中 x 是从零开始的索引,将由在该索引位置找到的附加参数取代(如果已指定)。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数,其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用本示例
      // Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.fatal("here is some channel info {0} and {1}", 15.4, true);
     
      // This will log the following String:
      //   "here is some channel info 15.4 and true"
      

info

()方法 
public function info(message:String, ... rest):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

使用 LogEvent.INFO 级别记录指定的数据。LogEventLevel.INFO,指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。

为日志记录指定的字符串可以包含使用括号括起来的索引,用于指示在记录字符串之前应该插入哪个附加参数。例如,当使用 10 和 15 作为参数进行调用时,“第一个附加参数是 {0},第二个附加参数是 {1}”将转化为“第一个附加参数是 10,第二个附加参数是 15”。

参数

message:String — 要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符,其中 x 是从零开始的索引,将由在该索引位置找到的附加参数取代(如果已指定)。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数,其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用本示例
      // Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.info("here is some channel info {0} and {1}", 15.4, true);
     
      // This will log the following String:
      //   "here is some channel info 15.4 and true"
      

log

()方法 
public function log(level:int, message:String, ... rest):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

在给定级别记录指定数据。

为日志记录指定的 String 可以包含使用括号括起来的索引,用于指示在记录 String 之前应该插入哪个附加参数。例如,当使用 10 和 15 作为参数进行调用时,“第一个附加参数是 {0},第二个附加参数是 {1}”将转化为“第一个附加参数是 10,第二个附加参数是 15”。

参数

level:int — 此信息应使用的记录级别。有效值为:
  • LogEventLevel.FATAL,指示负面影响严重且最终会导致应用程序失败的事件
  • LogEventLevel.ERROR,指示可能仍然允许应用程序继续运行的错误事件。
  • LogEventLevel.WARN,指示会对应用程序运行造成损害的事件
  • LogEventLevel.INFO,指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。
  • LogEventLevel.DEBUG,指示对调试应用程序大有帮助的细粒度级别的信息性消息。
 
message:String — 要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符,其中 x 是从零开始的索引,将由在该索引位置找到的附加参数取代(如果已指定)。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数,其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用本示例
      // Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.log(LogEventLevel.DEBUG, "here is some channel info {0} and {1}", LogEventLevel.DEBUG, 15.4, true);
     
      // This will log the following String as a DEBUG log message:
      //   "here is some channel info 15.4 and true"
      

warn

()方法 
public function warn(message:String, ... rest):void

语言版本: ActionScript 3.0
产品版本: Flex 3
运行时版本: Flash Player 9, AIR 1.1

使用 LogEventLevel.WARN 级别记录指定的数据。LogEventLevel.WARN,指示会对应用程序运行造成损害的事件。

为日志记录指定的字符串可以包含使用括号括起来的索引,用于指示在记录字符串之前应该插入哪个附加参数。例如,当使用 10 和 15 作为参数进行调用时,“第一个附加参数是 {0},第二个附加参数是 {1}”将转化为“第一个附加参数是 10,第二个附加参数是 15”。

参数

message:String — 要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符,其中 x 是从零开始的索引,将由在该索引位置找到的附加参数取代(如果已指定)。
 
... rest — 可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数,其中 x 是指定值的 Array 中一个从零开始的整数索引值。


示例
如何使用本示例
      // Get the logger for the mx.messaging.Channel "category"
      // and send some data to it.
      var logger:ILogger = Log.getLogger("mx.messaging.Channel");
      logger.warn("here is some channel info {0} and {1}", 15.4, true);
     
      // This will log the following String:
      //   "here is some channel info 15.4 and true"
      




[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。