mx.loggingLogEvent 代表单个日志记录事件的日志信息。flash.events:Event 代表单个日志记录事件的日志信息。每当进程请求记录信息时，日志记录系统就将分派单个事件。任何对象都可捕获此事件以进行存储或格式化。 LogEvent 构造函数。message包含日志数据的字符串。 level0此日志事件的级别。有效值为：

LogEventLevel.FATAL，指示负面影响严重且最终会导致应用程序失败的事件
LogEventLevel.ERROR，指示可能仍然允许应用程序继续运行的错误事件。
LogEventLevel.WARN，指示会对应用程序运行造成损害的事件
LogEventLevel.INFO，指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。
LogEventLevel.DEBUG，指示对调试应用程序大有帮助的细粒度级别的信息性消息。
LogEventLevel.ALL，旨在强制目标处理所有消息。

构造函数。 getLevelString 返回代表指定级别的字符串值。用英语指定的级别。 value需要获取相应字符串形式的级别。返回代表指定级别的字符串值。 LOG 事件类型常量；用于标识日志事件。log 事件类型常量；用于标识日志事件。 level 提供对此日志事件级别的访问。提供对此日志事件级别的访问。有效值为：

LogEventLogEventLevel.INFO，指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。
LogEventLevel.DEBUG，指示对调试应用程序大有帮助的细粒度级别的信息性消息。
LogEventLevel.ERROR，指示可能仍然允许应用程序继续运行的错误事件。
LogEventLevel.WARN，指示会对应用程序运行造成损害的事件。
LogEventLevel.FATAL，指示负面影响严重且最终会导致应用程序失败的事件。

message 提供对记录的消息的访问。提供对记录的消息的访问。 AbstractTarget 该类提供目标实现的日志记录框架所需的基本功能。mx.logging:ILoggingTargetmx.core:IMXMLObjectObject 该类提供目标实现的日志记录框架所需的基本功能。它处理滤镜表达式验证，并提供默认级别属性。未提供 logEvent() 方法的实现。 AbstractTarget 构造函数。构造函数。 addLogger 使用指定的记录器设置此目标。loggermx.logging:ILogger此目标应该侦听的 ILogger。使用指定的记录器设置此目标。这样，此目标就可以接收来自指定记录器的日志事件。 initialized 在创建了实现对象、并分配了标签上指定的所有属性后调用。document创建此对象的 MXML 文档。 id文档用于引用此对象。如果该对象是文档上的深层属性，则 id 为 null。在创建了实现对象、并分配了标签上指定的所有属性后调用。 logEvent 此方法处理相关记录器中的 LogEvent。eventmx.logging:LogEvent相关记录器中的事件。此方法处理相关记录器中的 LogEvent。目标使用此方法将事件转换为相应格式以便进行传输、存储或显示。仅当事件的级别在目标的级别范围内时才调用此方法。

注意：后代必须覆盖此方法才能使其发挥作用。

removeLogger 阻止此目标接收来自指定记录器的事件。loggermx.logging:ILogger此目标应该忽略的 ILogger。阻止此目标接收来自指定记录器的事件。 filters 除了 level 设置外，滤镜还可用于提供伪层次结构映射，以便仅处理那些给定类别的事件。除了 level 设置外，滤镜还可用于提供伪层次结构映射，以便仅处理那些给定类别的事件。

每个记录器都属于一个类别。一般而言，这些类别将映射到使用记录器的 fully-qualified 类名称。例如，记录 mx.rpc.soap.WebService 类的消息的记录器使用“mx.rpc.soap.WebService”作为 Log.getLogger() 方法调用的参数。当发送此类别的消息时，只有拥有与该类别匹配的滤镜的那些目标才能接收这些事件的通知。滤镜表达式可以包括通配符，用星号表示。通配符必须是表达式中最右端的字符。例如：rpc~~、mx.~~ 或者 ~~。如果指定的表达式无效，将引发 InvalidFilterError。如果指定了 null 或 []，则滤镜将设置为默认值 ["~~"]。

例如：

               var traceLogger:ILoggingTarget = new TraceTarget();
               traceLogger.filters = ["mx.rpc.~~", "mx.messaging.~~"];
               Log.addTarget(traceLogger);

id 提供对此目标的 ID 的访问。提供对此目标的 ID 的访问。如果将 ID 用作 mxml 标签，则会在运行时由 mxml 编译器分配；如果在脚本块中使用，则在内部分配。 level 提供对此目标的当前设置级别的访问。提供对此目标的当前设置级别的访问。有效值包括：

LogEventLevel.FATAL (1000)，指示负面影响严重且最终会导致应用程序失败的事件
LogEventLevel.ERROR (8)，指示可能仍然允许应用程序继续运行的错误事件。
LogEventLevel.WARN (6)，指示会对应用程序运行造成损害的事件
LogEventLevel.INFO (4)，指示粗略地介绍应用程序进度的说明性消息。
LogEventLevel.DEBUG (2)，指示对调试应用程序大有帮助的精细说明性消息。
LogEventLevel.ALL (0)，旨在强制目标处理所有消息。

LogEventLevel 一个静态类，其中包含要在 level 属性中使用的常数。Object 一个静态类，其中包含要在 level 属性中使用的常量。 ALL 通知目标处理所有消息。0 通知目标处理所有消息。 DEBUG 指示对调试应用程序大有帮助的细粒度级别的信息性消息。2 指示对调试应用程序大有帮助的细粒度级别的信息性消息。 ERROR 指示可能仍然允许应用程序继续运行的错误事件。8 指示可能仍然允许应用程序继续运行的错误事件。 FATAL 指示负面影响严重且最终会导致应用程序失败的事件。1000 指示负面影响严重且最终会导致应用程序失败的事件。 INFO 指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。4 指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。 WARN 指示会对应用程序运行造成损害的事件。6 指示会对应用程序运行造成损害的事件。 ILoggingTarget 日志记录框架中的所有记录器目标实现都必须实现此接口。日志记录框架中的所有记录器目标实现都必须实现此接口。 addLogger 使用指定的记录器设置此目标。loggermx.logging:ILogger此目标侦听的 ILogger。使用指定的记录器设置此目标。这样，此目标就可以接收来自指定记录器的日志事件。

注意：此方法由框架调用，您不应该进行直接调用。

removeLogger 阻止此目标接收来自指定记录器的事件。loggermx.logging:ILogger此目标忽略的 ILogger。阻止此目标接收来自指定记录器的事件。

注意：此方法由框架调用，您不应该进行直接调用。

filters 除了 level 设置外，滤镜还可用于提供伪层次结构映射，以便仅处理那些给定类别的事件。除了 level 设置外，滤镜还可用于提供伪层次结构映射，以便仅处理那些给定类别的事件。

每个记录器都属于一个类别。一般而言，这些类别将映射到使用记录器的完全限定类名称。例如，记录 mx.rpc.soap.WebService 类的消息的记录器将使用 "mx.rpc.soap.WebService" 作为 Log.getLogger() 调用的参数。当发送此类别的消息时，只有拥有与该类别匹配的滤镜的那些目标才能接收这些事件的通知。滤镜表达式可以包括通配符，用星号表示。通配符必须是表达式中最右端的字符。例如：rpc~~、mx.~~ 或者 ~~。如果指定的表达式无效，将引发 InvalidFilterError。空格和下列字符在滤镜表达式中无效：[]~$^&\/(){}<>+=`!#%?,:;'"@。

      var traceLogger:ILoggingTarget = new TraceTarget();
      traceLogger.filters = [ "mx.rpc.~~", "mx.messaging.~~" ];
      Log.addTarget(traceLogger);

level 提供对此目标的当前设置级别的访问。提供对此目标的当前设置级别的访问。有效值包括：

LogEventLevel.FATAL，指示负面影响严重且最终会导致应用程序失败的事件
LogEventLevel.ERROR，指示可能仍然允许应用程序继续运行的错误事件。
LogEventLevel.WARN，指示会对应用程序运行造成损害的事件
LogEventLevel.INFO，指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。
LogEventLevel.DEBUG，指示对调试应用程序大有帮助的细粒度级别的信息性消息。
LogEventLevel.ALL，旨在强制目标处理所有消息。

ILogger 日志记录框架中的所有记录器都必须实现此接口。flash.events:IEventDispatcher 日志记录框架中的所有记录器都必须实现此接口。 debug 使用 LogEventLevel.DEBUG 级别记录指定的数据。message要记录的信息。此字符串可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。 rest可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。使用 LogEventLevel.DEBUG 级别记录指定的数据。LogEventLevel.DEBUG，指示对调试应用程序大有帮助的细粒度级别的信息性消息。

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

      // 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 使用 LogEventLevel.ERROR 级别记录指定的数据。message要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。 rest可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。使用 LogEventLevel.ERROR 级别记录指定的数据。LogEventLevel.ERROR，指示可能仍然允许应用程序继续运行的错误事件。

      // 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 使用 LogEventLevel.FATAL 级别记录指定的数据。message要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。 rest可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。使用 LogEventLevel.FATAL 级别记录指定的数据。LogEventLevel.FATAL，指示负面影响严重且最终会导致应用程序失败的事件

      // 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 使用 LogEvent.INFO 级别记录指定的数据。message要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。 rest可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。使用 LogEvent.INFO 级别记录指定的数据。LogEventLevel.INFO，指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。

      // 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 在给定级别记录指定数据。level此信息应使用的记录级别。有效值为：

LogEventLevel.FATAL，指示负面影响严重且最终会导致应用程序失败的事件
LogEventLevel.ERROR，指示可能仍然允许应用程序继续运行的错误事件。
LogEventLevel.WARN，指示会对应用程序运行造成损害的事件
LogEventLevel.INFO，指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。
LogEventLevel.DEBUG，指示对调试应用程序大有帮助的细粒度级别的信息性消息。

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

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

      // 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 使用 LogEventLevel.WARN 级别记录指定的数据。message要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。 rest可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。使用 LogEventLevel.WARN 级别记录指定的数据。LogEventLevel.WARN，指示会对应用程序运行造成损害的事件。

      // 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"

category 记录器的类别值。记录器的类别值。 Log 为伪层次结构日志记录功能提供多种格式和输出选项。Object 为伪层次结构日志记录功能提供多种格式和输出选项。日志系统包含两个主要组件：记录器和目标。您可以使用记录器向目标发送信息。目标负责设置日志数据的格式，以及日志数据的一般性输出。

记录器是为特殊类别的信息创建的 singleton 实例。通常，类别是希望记录信息的组件的包名称。通过类别，用户可以指定自己感兴趣的日志信息。您可以选择多个类别并使用正则表达式将其合并。这样可以扩大或缩小获取的日志记录信息的范围。例如，您也许对“mx.messaging”和“mx.rpc”包下的所有日志信息感兴趣，并希望这些包中的内容的输出格式为 XML。要获得“mx.messaging”类别（包括子包和组件）下的所有日志信息，则需要通配符表达式，如“mx.messaging.~~”。有关更多详细信息，请参阅下文中的代码示例。

目标提供记录的数据的输出机制。此机制通常包括格式设置、传输或存储，但可以是 VM 下的任何内容。提供了两个目标：MiniDebugTarget 和 TraceTarget。其中的每个写入程序都获取当前日志信息并将其“发送”到某个位置进行显示和/或存储。目标还为要输出哪些日志数据提供了规范。

  ... 
  import mx.logging.targets.
  import mx.logging.
 
  private function initLogging():void {
      // Create a target.
      var logTarget:TraceTarget = new TraceTarget();
 
      // Log only messages for the classes in the mx.rpc.and 
      // mx.messaging packages.
      logTarget.filters=["mx.rpc.,"mx.messaging.];
 
      // Log all log levels.
      logTarget.level = LogEventLevel.ALL;
 
      // Add date, time, category, and log level to the output.
      logTarget.includeDate = true;
      logTarget.includeTime = true;
      logTarget.includeCategory = true;
      logTarget.includeLevel = true;
 
      // Begin logging.
      Log.addTarget(logTarget);
  } 
  ...

addTarget 允许指定的目标开始接收日志事件的通知。targetmx.logging:ILoggingTarget应该捕获日志事件的特定目标。允许指定的目标开始接收日志事件的通知。 flush 此方法将从缓存中删除当前的所有记录器。此方法将从缓存中删除当前的所有记录器。随后，将调用 getLogger() 方法返回记录器的新实例，而不会返回先前的任何同类别实例。此方法仅适用于调试。 getLogger 返回与指定类别关联的记录器。指定名称的记录器对象的实例。如果此名称不存在，则返回使用此指定名称的新实例。 mx.logging:ILoggercategory应该返回的记录器的类别。返回与指定类别关联的记录器。如果给定的类别不存在，则返回新的记录器实例，并将其与该类别关联。类别必须至少有一个字符的长度，并且可能不允许包含任何空白或下列任一字符：[]~$^&\/(){}<>+=`!#%?,:;'"@ 如果指定的类别格式错误，则此方法将引发 InvalidCategoryError。 hasIllegalCharacters 此方法检查指定的字符串值中是否存在非法字符。若发现任何非法字符，则为 true；否则，为 false value要从中检查非法字符的 String。下列字符为非法字符：[]~$^&\/(){}<>+=`!#%?,:;'"@ 此方法检查指定的字符串值中是否存在非法字符。 isDebug 指示日志目标是否会处理调试级别的日志事件。如果记录调试级别的日志事件，则为 true；否则，为 false。指示日志目标是否会处理调试级别的日志事件。 isError 指示日志目标是否处理错误级别的日志事件。如果记录错误级别的日志事件，则为 true；否则，为 false。指示日志目标是否处理错误级别的日志事件。 isFatal 指示日志目标是否处理严重级别的日志事件。如果记录严重级别的日志事件，则为 true；否则，为 false。指示日志目标是否处理严重级别的日志事件。 isInfo 指示日志目标是否处理信息级别的日志事件。如果记录信息级别的日志事件，则为 true；否则，为 false。指示日志目标是否处理信息级别的日志事件。 isWarn 指示日志目标是否处理警告级别的日志事件。如果记录警告级别的日志事件，则为 true；否则，为 false。指示日志目标是否处理警告级别的日志事件。 removeTarget 停止指定的目标接收日志事件的通知。targetmx.logging:ILoggingTarget应该捕获日志事件的特定目标。停止指定的目标接收日志事件的通知。 LogLogger 在日志记录框架中使用的记录器。mx.logging:ILoggerflash.events:EventDispatcher 在日志记录框架中使用的记录器。此类为使用 log() 方法记录的每条消息分派事件。 LogLogger 构造函数。category此日志发送的消息所属的类别。构造函数。 debug 使用 LogEventLevel.DEBUG 级别记录指定的数据。msg要记录的信息。此字符串可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。 rest可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。使用 LogEventLevel.DEBUG 级别记录指定的数据。LogEventLevel.DEBUG，指示对调试应用程序大有帮助的细粒度级别的信息性消息。

error 使用 LogEventLevel.ERROR 级别记录指定的数据。msg要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。 rest可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。使用 LogEventLevel.ERROR 级别记录指定的数据。LogEventLevel.ERROR，指示可能仍然允许应用程序继续运行的错误事件。

fatal 使用 LogEventLevel.FATAL 级别记录指定的数据。msg要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。 rest可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。使用 LogEventLevel.FATAL 级别记录指定的数据。LogEventLevel.FATAL，指示负面影响严重且最终会导致应用程序失败的事件

info 使用 LogEvent.INFO 级别记录指定的数据。msg要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。 rest可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。使用 LogEvent.INFO 级别记录指定的数据。LogEventLevel.INFO，指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。

log 在给定级别记录指定数据。level此信息应使用的记录级别。有效值为：

LogEventLevel.FATAL，指示负面影响严重且最终会导致应用程序失败的事件
LogEventLevel.ERROR，指示可能仍然允许应用程序继续运行的错误事件。
LogEventLevel.WARN，指示会对应用程序运行造成损害的事件
LogEventLevel.INFO，指示在粗粒度级别重点介绍应用程序运行情况的信息性消息。
LogEventLevel.DEBUG，指示对调试应用程序大有帮助的细粒度级别的信息性消息。

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

warn 使用 LogEventLevel.WARN 级别记录指定的数据。msg要记录的信息。此 String 可以包含 {x} 形式的特殊标记字符，其中 x 是从零开始的索引，将由在该索引位置找到的附加参数取代（如果已指定）。 rest可以在字符串参数中的每个“{x}”位置处作为替代内容的附加参数，其中 x 是指定值的 Array 中一个从零开始的整数索引值。使用 LogEventLevel.WARN 级别记录指定的数据。LogEventLevel.WARN，指示会对应用程序运行造成损害的事件。

category 此记录器发送的消息的类别。此记录器发送的消息的类别。