Log 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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
- 继承
- 特性
注解
用于发送日志输出的 API。
通常,应使用
从最小到大多数详细程度的顺序是 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,则不会记录堆栈跟踪。
注意:此类中日志记录函数的返回值可能因日志记录实现的更改而不同。 对于返回整数的方法,可以将正值视为成功的调用。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| 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) |
方法
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |