SimpleFormatter.Format(LogRecord) 方法

定义

命名空间:

Java.Util.Logging

程序集:

Mono.Android.dll

设置给定 LogRecord 的格式。

[Android.Runtime.Register("format", "(Ljava/util/logging/LogRecord;)Ljava/lang/String;", "GetFormat_Ljava_util_logging_LogRecord_Handler")]
public override string? Format (Java.Util.Logging.LogRecord? record);

[<Android.Runtime.Register("format", "(Ljava/util/logging/LogRecord;)Ljava/lang/String;", "GetFormat_Ljava_util_logging_LogRecord_Handler")>]
override this.Format : Java.Util.Logging.LogRecord -> string

参数

record

LogRecord

要格式化的日志记录。

返回

String

格式化的日志记录

属性

RegisterAttribute

注解

设置给定 LogRecord 的格式。

可以通过在 c>java.util.logging.SimpleFormatter.format</c> 属性中<指定格式字符串来自定义格式。 LogRecord给定的格式将好像通过调用：

{@link String#format String.format}(format, date, source, logger, level, message, thrown);

其中参数为：<br<>ol><liformat> - 属性java.util.Formatter java.util.Formatter或默认格式中指定的java.util.logging.SimpleFormatter.format格式字符串。</li><date> - 表示Date日志记录的 LogRecord#getMillis 事件时间的对象。</li>source<> - 表示调用方（如果可用）的字符串;否则为记录器的名称。</li>logger<> - 记录器的名称。</li>level<> - Level#getLocalizedName 日志级别。</li>message<> - 从Formatter#formatMessage(LogRecord)方法返回的格式化日志消息。 它使用java.text.MessageFormat java.text格式设置，不使用java.util.Formatter format参数。</li>thrown<> - 表示与日志记录关联的 LogRecord#getThrown 的字符串，其回溯以换行符开头（如果有）;否则为空字符串。</li></ol>

一些示例格式：<br><ul><li>java.util.logging.SimpleFormatter.format="%4$s: %5$s [%1$tc]%n"

这将打印 1 行与日志级别（4$）、日志消息（5$）和时间戳（1$）在方括号中。

WARNING: warning message [Tue Mar 22 13:11:31 PDT 2011]

</li li><>java.util.logging.SimpleFormatter.format="%1$tc %2$s%n%4$s: %5$s%6$s%n"

这会输出 2 行，其中第一行包括时间戳（1$）和源（2$）;第二行包括日志级别（4$）和日志消息（5$）后跟可引发的和回溯（6$如果有）：

Tue Mar 22 13:11:31 PDT 2011 MyClass fatal
                SEVERE: several message with an exception
                java.lang.IllegalArgumentException: invalid argument
                        at MyClass.mash(MyClass.java:9)
                        at MyClass.crunch(MyClass.java:6)
                        at MyClass.main(MyClass.java:3)

</li li><>java.util.logging.SimpleFormatter.format="%1$tb %1$td, %1$tY %1$tl:%1$tM:%1$tS %1$Tp %2$s%n%4$s: %5$s%n"

这会打印与上述示例类似的 2 行，其日期/时间格式不同，并且不打印可引发的行及其回溯：

Mar 22, 2011 1:11:31 PM MyClass fatal
                SEVERE: several message with an exception

</li></ul>

也可以在子类中重写此方法。 建议使用 Formatter#formatMessage 便捷方法本地化和设置消息字段的格式。

适用于 . 的 java.util.logging.SimpleFormatter.format(java.util.logging.LogRecord)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。