语言

Log 类

定义

用于发送日志输出的 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
继承
特性

注解

用于发送日志输出的 API。

通常,应使用 > 和方法来写入日志。 然后,可以在 logcat 中查看日志。

从最小到大多数详细程度的顺序是 ERROR、WARN、INFO、DEBUG、VERBOSE。

提示: 良好的约定是在类中声明 TAG 常量:

private static final String TAG = "MyActivity";

并在对日志方法的后续调用中使用。 </p>

提示: 别忘了, 当你打电话时, 就像

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

在生成要传入 Log.d 的字符串时,编译器会使用 StringBuilder,并发生至少三个分配:StringBuilder 本身、缓冲区和 String 对象。 实际上,还有另一个缓冲区分配和复制,甚至对 gc 施加更大的压力。 这意味着,如果日志消息被筛选掉,则可能要执行大量工作并产生重大开销。

调用采用 Throwable 参数的日志方法时,如果原因链中的任何一个可引发项是一个 UnknownHostException,则不会记录堆栈跟踪。

注意:此类中日志记录函数的返回值可能因日志记录实现的更改而不同。 对于返回整数的方法,可以将正值视为成功的调用。

Java文档android.util.Log。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
FormatProvider

传递给任何基础字符串的 IFormatProvider。Format() 调用。 默认为 System.Globalization.CultureInfo.CurrentCulture。

Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)
ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)

方法

名称 说明
Clone()

创建并返回此对象的副本。

(继承自 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 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()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 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)

用于从可引发的堆栈获取可记录堆栈跟踪的方便函数

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)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 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()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 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)

多么可怕的失败:报告一个不应该发生的异常。

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于