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><li>format - java.util.Formatter java.util.Formatter 屬性或預設格式中指定的java.util.logging.SimpleFormatter.format格式字串。</li li>date>< - Date 物件，代表記錄檔記錄的 LogRecord#getMillis 事件時間。</li li>>source< - 代表呼叫端的字串，如果有的話，則為 ，否則為記錄器的名稱。</li li>>logger< - 記錄器的名稱。</li li>>level< - Level#getLocalizedName 記錄層級。</li li>>message< - 從 Formatter#formatMessage(LogRecord) 方法傳回的格式化記錄訊息。 它會使用java.text.MessageFormat java.text格式設定，而且不使用 java.util.Formatter format 自變數。</li 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 屬性授權中所述的詞彙使用。