FileHandler 類別

定義

命名空間:

Java.Util.Logging

組件:

Mono.Android.dll

簡單的檔案記錄 Handler。

[Android.Runtime.Register("java/util/logging/FileHandler", DoNotGenerateAcw=true)]
public class FileHandler : Java.Util.Logging.StreamHandler

[<Android.Runtime.Register("java/util/logging/FileHandler", DoNotGenerateAcw=true)>]
type FileHandler = class
    inherit StreamHandler

繼承

Object

Object

Handler

StreamHandler

FileHandler

屬性

RegisterAttribute

備註

簡單的檔案記錄 Handler。

FileHandler可以寫入指定的檔案，也可以寫入旋轉的檔案集。

對於一組旋轉的檔案，因為每個檔案都達到指定的大小限制，所以會關閉、輪替，以及開啟新的檔案。 後續較舊的檔案會藉由將 「0」、“1” 、“ 2 等新增至基底檔名來命名。

根據預設，IO 連結庫中會啟用緩衝處理，但完成時會清除每個記錄檔記錄。

根據預設，類別 XMLFormatter 會用於格式化。

<b>Configuration：</b> 預設會 FileHandler 使用下列 LogManager 組態屬性初始化，其中 <handler-name> 參考處理程式的完整類別名稱。 如果未定義屬性（或具有無效的值），則會使用指定的預設值。 <ul><li> 。level 指定 的預設層級 Handler （預設值為 Level.ALL）。 </li li><> 。filter 指定要使用之Filter類別的名稱（預設值為 no Filter）。 </li li><> 。formatter 指定要使用之Formatter類別的名稱（預設為 java.util.logging.XMLFormatter） </li li><> 。編碼要使用的字元集編碼名稱（預設為預設平臺編碼）。 </li li><> 。limit 會指定要寫入任何一個檔案的近似最大值（以位元組為單位）。 如果這是零，則沒有任何限制。 （預設值為無限制）。 </li li><> 。count 會指定要循環的輸出檔案數目（預設值為 1）。 </li li><> 。pattern 會指定產生輸出檔名的模式。 如需詳細資料，請參閱下文。 （預設為“%h/java%u.log”。 </li li><> 。append 指定 FileHandler 是否應該附加至任何現有的檔案（預設值為 false）。 </li></ul>

例如，的屬性會是：ul<li java.util.logging.FileHandler.level=INFO </li li>>< java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter </li></ul FileHandler>><>

對於自定義處理程式，e.g. com.foo.MyHandler，屬性會是：ul>li com.foo.MyHandler.level=INFO </li li><> com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter </li<>/ul><<>

模式包含字串，其中包含將在運行時間取代的下列特殊元件：ul>li “/” 本機路徑名稱分隔符 </li><> “%t” 系統暫存目錄 </li “%h” “%h” “user.home” 系統屬性>><< /li>>< “%g” 的世代號碼，以區分旋轉<記錄 /<>>li “%u” 的唯一數位來解決衝突 </li li>><><<“%%” 會轉譯成單一百分比符號 “%” </li></ul> 如果尚未指定 “%g” 字段，而且檔案計數大於一個，則會在點之後，將產生編號新增至產生的檔名結尾。

因此，例如計數為 2 的 「%t/java%g.log」 模式，通常會導致將記錄檔寫入至 /var/tmp/java0.log 和 /var/tmp/java1.log，而在 Windows 95 上，它們通常會寫入 C：\TEMP\java0.log 和 C：\TEMP\java1.log

世代號碼遵循序列 0、1、2 等。

一般而言，“%u” 唯一字段會設定為 0。 不過，如果 FileHandler 嘗試開啟檔名並發現檔案目前正由另一個進程使用，則會遞增唯一的數位字段，然後再試一次。 這將會重複，直到 FileHandler 找到目前未使用的檔名為止。 如果發生衝突且未指定 「%u」 欄位，則會在點之後的檔名結尾新增。 （這會在任何自動新增的世代號碼之後。

因此，如果三個進程都嘗試登入fred%u.%g.txt，則它們最終可能會使用fred0.0.txt，fred1.0.txt，fred2.0.txt作為輪替序列中的第一個檔案。

請注意，使用唯一標識碼以避免衝突，只有在使用本機磁碟文件系統時才能可靠地運作。

已在1.4中新增。

的 java.util.logging.FileHandlerJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

FileHandler()	建構預設 FileHandler。
FileHandler(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。
FileHandler(String)	FileHandler初始化 ，以寫入指定的檔名。
FileHandler(String, Boolean)	FileHandler使用選擇性附加，初始化 以寫入指定的檔名。
FileHandler(String, Int32, Int32)	FileHandler初始化 以寫入至一組檔案。
FileHandler(String, Int32, Int32, Boolean)	FileHandler初始化 ，以使用選擇性附加寫入至一組檔案。

屬性

Class	傳回這個 Object的運行時間類別。 (繼承來源 Object)
Encoding	傳回這個 Handler的字元編碼。 -或- 設定這個 Handler所使用的字元編碼。 (繼承來源 Handler)
ErrorManager	擷取這個處理程式的 ErrorManager。 -或- 定義這個處理程式的 ErrorManager。 (繼承來源 Handler)
Filter	取得這個 Handler的目前 Filter 。 -或- 設定 Filter 以控制這個 Handler上的輸出。 (繼承來源 Handler)
Formatter	Formatter傳回這個 Handler的 。 -或- 設定 Formatter。 (繼承來源 Handler)
Handle	基礎Android實例的句柄。 (繼承來源 Object)
JniIdentityHashCode	簡單的檔案記錄 Handler。 (繼承來源 Object)
JniPeerMembers	簡單的檔案記錄 Handler。
Level	取得記錄層級，指定這個 Handler將記錄哪些訊息。 -或- 設定記錄層級，指定這個 Handler將記錄哪些訊息層級。 (繼承來源 Handler)
PeerReference	簡單的檔案記錄 Handler。 (繼承來源 Object)
ThresholdClass	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。
ThresholdType	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。

方法

Clone()	建立並傳回這個 對象的複本。 (繼承來源 Object)
Close()	關閉目前的輸出數據流。 (繼承來源 StreamHandler)
Dispose()	簡單的檔案記錄 Handler。 (繼承來源 Object)
Dispose(Boolean)	簡單的檔案記錄 Handler。 (繼承來源 Object)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
Flush()	清除任何緩衝的訊息。 (繼承來源 StreamHandler)
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
IsLoggable(LogRecord)	檢查這 Handler 是否會實際記錄指定的 LogRecord。 (繼承來源 Handler)
JavaFinalize()	當垃圾收集決定不再參考物件時，垃圾收集行程在 物件上呼叫。 (繼承來源 Object)
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
Publish(LogRecord)	格式化和發佈 LogRecord。 (繼承來源 StreamHandler)
ReportError(String, Exception, Int32)	受保護的便利方法，可將錯誤回報給此處理程式的 ErrorManager。 (繼承來源 Handler)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetOutputStream(Stream)	變更輸出數據流。 (繼承來源 StreamHandler)
ToArray<T>()	簡單的檔案記錄 Handler。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	簡單的檔案記錄 Handler。 (繼承來源 Object)
Wait()	讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)

明確介面實作

IJavaPeerable.Disposed()	簡單的檔案記錄 Handler。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	簡單的檔案記錄 Handler。 (繼承來源 Object)
IJavaPeerable.Finalized()	簡單的檔案記錄 Handler。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	簡單的檔案記錄 Handler。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	簡單的檔案記錄 Handler。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	簡單的檔案記錄 Handler。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	簡單的檔案記錄 Handler。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	簡單的檔案記錄 Handler。
GetJniTypeName(IJavaPeerable)	簡單的檔案記錄 Handler。