FileHandler 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
簡單的檔案記錄 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
- 繼承
- 屬性
備註
簡單的檔案記錄 Handler
。
FileHandler
可以寫入指定的檔案,也可以寫入旋轉的檔案集。
對於一組旋轉的檔案,因為每個檔案都達到指定的大小限制,所以會關閉、輪替,以及開啟新的檔案。 後續較舊的檔案會藉由將 「0」、“1” 、“ 2 等新增至基底檔名來命名。
根據預設,IO 連結庫中會啟用緩衝處理,但完成時會清除每個記錄檔記錄。
根據預設,類別 XMLFormatter
會用於格式化。
<b>Configuration:</b> 預設會 FileHandler
使用下列 LogManager
組態屬性初始化,其中 <handler-name>
參考處理程式的完整類別名稱。 如果未定義屬性(或具有無效的值),則會使用指定的預設值。 <ul><li> Handler
(預設值為 Level.ALL
)。 </li li><> Filter
類別的名稱(預設值為 no Filter
)。 </li li><> Formatter
類別的名稱(預設為 java.util.logging.XMLFormatter
) </li li><>
例如,的屬性會是: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.FileHandler
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
FileHandler() |
建構預設 |
FileHandler(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
FileHandler(String) |
|
FileHandler(String, Boolean) |
|
FileHandler(String, Int32, Int32) |
|
FileHandler(String, Int32, Int32, Boolean) |
|
屬性
Class |
傳回這個 |
Encoding |
傳回這個 |
ErrorManager |
擷取這個處理程式的 ErrorManager。 -或- 定義這個處理程式的 ErrorManager。 (繼承來源 Handler) |
Filter |
取得這個 |
Formatter |
|
Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
JniIdentityHashCode |
簡單的檔案記錄 |
JniPeerMembers |
簡單的檔案記錄 |
Level |
取得記錄層級,指定這個 |
PeerReference |
簡單的檔案記錄 |
ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
方法
Clone() |
建立並傳回這個 對象的複本。 (繼承來源 Object) |
Close() |
關閉目前的輸出數據流。 (繼承來源 StreamHandler) |
Dispose() |
簡單的檔案記錄 |
Dispose(Boolean) |
簡單的檔案記錄 |
Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
Flush() |
清除任何緩衝的訊息。 (繼承來源 StreamHandler) |
GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
IsLoggable(LogRecord) |
檢查這 |
JavaFinalize() |
當垃圾收集決定不再參考物件時,垃圾收集行程在 物件上呼叫。 (繼承來源 Object) |
Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
Publish(LogRecord) |
格式化和發佈 |
ReportError(String, Exception, Int32) |
受保護的便利方法,可將錯誤回報給此處理程式的 ErrorManager。 (繼承來源 Handler) |
SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
SetOutputStream(Stream) |
變更輸出數據流。 (繼承來源 StreamHandler) |
ToArray<T>() |
簡單的檔案記錄 |
ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
UnregisterFromRuntime() |
簡單的檔案記錄 |
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() |
簡單的檔案記錄 |
IJavaPeerable.DisposeUnlessReferenced() |
簡單的檔案記錄 |
IJavaPeerable.Finalized() |
簡單的檔案記錄 |
IJavaPeerable.JniManagedPeerState |
簡單的檔案記錄 |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
簡單的檔案記錄 |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
簡單的檔案記錄 |
IJavaPeerable.SetPeerReference(JniObjectReference) |
簡單的檔案記錄 |
擴充方法
JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
JavaCast<TResult>(IJavaObject) |
簡單的檔案記錄 |
GetJniTypeName(IJavaPeerable) |
簡單的檔案記錄 |