SoftReference 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
软引用对象，根据内存需求，由垃圾回收器自行清除。
[Android.Runtime.Register("java/lang/ref/SoftReference", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public class SoftReference : Java.Lang.Ref.Reference[<Android.Runtime.Register("java/lang/ref/SoftReference", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
type SoftReference = class
inherit Reference- 继承
- 属性
注解
软引用对象，根据内存需求，由垃圾回收器自行清除。
假设垃圾回收器确定某个对象在某个时间点是软可访问的。 此时，它可以选择清除对该对象的所有软引用，以及对该对象可通过强引用链访问的任何其他可软访问对象的所有软引用。 同时或稍后将排队那些向引用队列注册的新清除的软引用。
在虚拟机引发 OutOfMemoryError 之前，保证已清除对可软访问对象的所有软引用。 否则，不会对软引用清除的时间或清除对不同对象的一组此类引用的顺序施加任何约束。 但是，鼓励虚拟机实现对清除最近创建的或最近使用的软引用产生偏见。
<h3>避免缓存<的软引用/h3> 在实践中，软引用对于缓存效率低下。 运行时没有足够的信息来说明要清除的引用以及要保留哪些引用。 最致命的是，当考虑到清除软引用和增大堆之间的选择时，它不知道该怎么做。
对每个引用的应用程序的值缺乏信息会限制软引用的有用性。 清除过早的引用会导致不必要的工作;那些被清除太晚的浪费内存的人。
大多数应用程序应使用 android.util.LruCache 而不是软引用。 LruCache 具有有效的逐出策略，允许用户优化分配的内存量。
已在 1.2 中添加。
适用于 . 的 java.lang.ref.SoftReferenceJava 文档
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
构造函数
| SoftReference(IntPtr, JniHandleOwnership) |
创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。 |
| SoftReference(Object) |
创建引用给定对象的新软引用。 |
| SoftReference(Object, ReferenceQueue) |
创建一个新的软引用，该引用引用给定对象，并注册到给定队列。 |
属性
| Class |
返回此 |
| 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) |
测试此引用对象的引用是否为 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| ToArray<T>() |
软引用对象，根据内存需求，由垃圾回收器自行清除。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
软引用对象，根据内存需求，由垃圾回收器自行清除。 (继承自 Object) |
| Wait() |
使当前线程等待，直到唤醒它，通常是通过 em 通知/em> 或 <em>interrupted</em>。<>< (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒，通常是通过 <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) |
扩展方法
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
软引用对象，根据内存需求，由垃圾回收器自行清除。 |
| GetJniTypeName(IJavaPeerable) |
软引用对象，根据内存需求，由垃圾回收器自行清除。 |