Log 類別

定義

命名空間:: Android.Util

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

用於傳送日誌輸出的 API。

[Android.Runtime.Register("android/util/Log", DoNotGenerateAcw=true)]
public sealed class Log : Java.Lang.Object

[<Android.Runtime.Register("android/util/Log", DoNotGenerateAcw=true)>]
type Log = class
    inherit Object

繼承: Object

JavaObject

Object
Log

屬性: RegisterAttribute

備註

用於傳送日誌輸出的 API。

一般來說，你應該使用 #v Log.v()、 #d Log.d()、 #i Log.i()、 #w Log.w()#e Log.e() 和方法來撰寫日誌。接著你可以在 logcat 裡查看這些日誌。

依字數從少到多的順序是 ERROR、WARN、INFO、DEBUG、VERBOSE。

提示： 一個好的慣例是在你的類別中宣告一個 TAG 常數：

private static final String TAG = "MyActivity";

並在後續呼叫日誌方法時使用此資訊。

提示： 打電話時別忘了這點

Log.v(TAG, "index=" + i);

當你建置字串以傳送到 Log.d 時，編譯器會使用 StringBuilder，並且至少會進行三個配置：StringBuilder 本身、緩衝區和 String 物件。實際上，還有另一個緩衝區分配和複製，群組承受的壓力更大。這表示如果你的日誌訊息被過濾掉，你可能會做大量工作並產生相當多的開銷。

當呼叫那些使用 Throwable 參數的日誌方法時，如果原因鏈中有任何 throwable 是 UnknownHostException，則堆疊追蹤不會被記錄。

注意：由於日誌實作的變更，本類別日誌函式的回傳值可能因 Android 版本而異。對於回傳整數的方法，正值可視為成功的呼叫。

Java 文件 android.util.Log。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
FormatProvider	IFormatProvider 會傳遞給任何底層字串。Format（）呼叫。預設為系統。全球化。文化資訊。當前文化。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)
JniPeerMembers	用於傳送日誌輸出的 API。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)
Debug(String, String, Object[])	Debug發送使用複合格式字串的日誌訊息。
Debug(String, String)	發送 `#DEBUG` 日誌訊息。
Debug(String, Throwable, String, Object[])	以複合格式字串發送 Debug 日誌訊息，並附帶 Throwable。
Debug(String, Throwable, String)	傳送 Debug 帶有關聯 Throwable的日誌訊息。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)
Equals(Object)	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
Error(String, String, Object[])	Error發送使用複合格式字串的日誌訊息。
Error(String, String)	發送 `#ERROR` 日誌訊息。
Error(String, Throwable, String, Object[])	以複合格式字串發送 Error 日誌訊息，並附帶 Throwable。
Error(String, Throwable, String)	傳送 Error 帶有關聯 Throwable的日誌訊息。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetStackTraceString(Throwable)	一個方便的功能，可以從 Throwable 取得可記錄的堆疊追蹤
Info(String, String, Object[])	Info發送使用複合格式字串的日誌訊息。
Info(String, String)	發送 `#INFO` 日誌訊息。
Info(String, Throwable, String, Object[])	以複合格式字串發送 Info 日誌訊息，並附帶 Throwable。
Info(String, Throwable, String)	傳送 Info 帶有關聯 Throwable的日誌訊息。
IsLoggable(String, LogPriority)	檢查指定標籤的日誌是否可在指定層級記錄。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Verbose(String, String, Object[])	Verbose發送使用複合格式字串的日誌訊息。
Verbose(String, String)	發送 `#VERBOSE` 日誌訊息。
Verbose(String, Throwable, String, Object[])	以複合格式字串發送 Verbose 日誌訊息，並附帶 Throwable。
Verbose(String, Throwable, String)	傳送 Verbose 帶有關聯 Throwable的日誌訊息。
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Warn(String, String, Object[])	Warn發送使用複合格式字串的日誌訊息。
Warn(String, String)	發送 `#WARN` 日誌訊息。
Warn(String, Throwable, String, Object[])	以複合格式字串發送 Warn 日誌訊息，並附帶 Throwable。
Warn(String, Throwable, String)	傳送 Warn 帶有關聯 Throwable的日誌訊息。
Warn(String, Throwable)	發送 `#WARN` 日誌訊息並記錄異常。
WriteLine(LogPriority, String, String, Object[])	以指定優先順序使用複合格式字串寫入日誌訊息。
WriteLine(LogPriority, String, String)	低階日誌呼叫。
Wtf(String, String, Object[])	使用 Assert 複合格式字串傳送日誌訊息（由 `Log.wtf`使用的優先權）。
Wtf(String, String)	多麼嚴重的失敗：報告一個本不該發生的狀況。
Wtf(String, Throwable, String, Object[])	Assert發送日誌訊息（由 `Log.wtf`使用的優先順序），使用複合格式字串，並附帶 Throwable。
Wtf(String, Throwable, String)	發送 Assert 日誌訊息（由 `Log.wtf`使用的優先順序），並帶有相應 Throwable的。
Wtf(String, Throwable)	多麼嚴重的失敗：回報一個本不該發生的例外。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	用於傳送日誌輸出的 API。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	用於傳送日誌輸出的 API。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於