PhantomReference 类

定义

在收集器确定其引用可以回收后排队的虚拟引用对象。

[Android.Runtime.Register("java/lang/ref/PhantomReference", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public class PhantomReference : Java.Lang.Ref.Reference
[<Android.Runtime.Register("java/lang/ref/PhantomReference", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
type PhantomReference = class
    inherit Reference
继承
PhantomReference
属性

注解

在收集器确定其引用可以回收后排队的虚拟引用对象。 幻影引用最常用于计划验尸后清理操作。

假设垃圾回收器确定某个对象在某个时间点是可到达的。 此时,它将以原子方式清除对该对象的所有虚拟引用,以及对该对象可访问的任何其他可幻影对象的所有虚拟引用。 同时或稍后,它将排队那些向引用队列注册的新清除的虚拟引用。

为了确保可回收对象保持不变,可能无法检索虚拟引用的引用: get 幻影引用的方法始终返回 null

已在 1.2 中添加。

Java文档java.lang.ref.PhantomReference

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

构造函数

名称 说明
PhantomReference(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

PhantomReference(Object, ReferenceQueue)

创建一个新的虚拟引用,该引用给定对象并注册到给定队列。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
IsEnqueued

测试此引用对象是否在其关联的队列中(如果有)。

(继承自 Reference)
JniIdentityHashCode

在收集器确定其引用可以回收后排队的虚拟引用对象。

(继承自 Object)
JniPeerMembers

在收集器确定其引用可以回收后排队的虚拟引用对象。

PeerReference

在收集器确定其引用可以回收后排队的虚拟引用对象。

(继承自 Object)
ThresholdClass

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

ThresholdType

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

方法

名称 说明
Clear()

清除此引用对象。

(继承自 Reference)
Clone()

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

(继承自 Object)
Dispose()

在收集器确定其引用可以回收后排队的虚拟引用对象。

(继承自 Object)
Dispose(Boolean)

在收集器确定其引用可以回收后排队的虚拟引用对象。

(继承自 Object)
Enqueue()

将此引用对象添加到向其注册的队列(如果有)。

(继承自 Reference)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
Get()

返回此引用对象的引用。

(继承自 Reference)
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
RefersTo(Object)

测试此引用对象的引用是否为 obj

(继承自 Reference)
SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
ToArray<T>()

在收集器确定其引用可以回收后排队的虚拟引用对象。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

在收集器确定其引用可以回收后排队的虚拟引用对象。

(继承自 Object)
Wait()

使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><>

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

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IJavaPeerable.Disposed()

在收集器确定其引用可以回收后排队的虚拟引用对象。

(继承自 Object)
IJavaPeerable.DisposeUnlessReferenced()

在收集器确定其引用可以回收后排队的虚拟引用对象。

(继承自 Object)
IJavaPeerable.Finalized()

在收集器确定其引用可以回收后排队的虚拟引用对象。

(继承自 Object)
IJavaPeerable.JniManagedPeerState

在收集器确定其引用可以回收后排队的虚拟引用对象。

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

在收集器确定其引用可以回收后排队的虚拟引用对象。

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

在收集器确定其引用可以回收后排队的虚拟引用对象。

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

在收集器确定其引用可以回收后排队的虚拟引用对象。

(继承自 Object)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

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

JavaAs<TResult>(IJavaPeerable)

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

JavaCast<TResult>(IJavaObject)

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

JavaCast<TResult>(IJavaObject)

在收集器确定其引用可以回收后排队的虚拟引用对象。

TryJavaCast<TResult>(IJavaPeerable, TResult)

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

适用于