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> 實務上，軟參考對快取效率不高。 執行時間沒有足夠的資訊說明哪些引用該清除、哪些該保留。 最致命的是，當面臨清除軟參考和擴大堆積之間選擇時，它不知道該怎麼做。
缺乏關於每個參考文獻應用價值的資訊，限制了軟性參考的實用性。 過早清除的參考文獻會造成不必要的工作;那些被清除得太晚的會浪費記憶。
大多數應用程式應該使用 an android.util.LruCache 而非軟參考。 LruCache 有有效的驅逐政策，並允許使用者調整分配的記憶體數量。
在 1.2 版本中加入。
Java 文件 java.lang.ref.SoftReference。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| SoftReference(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
| SoftReference(Object, ReferenceQueue) |
建立一個新的軟參考，指向給定物件並註冊給定佇列。 |
| SoftReference(Object) |
建立一個新的軟參考，指向給定的物件。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| IsEnqueued |
測試該參考物件是否在其對應佇列中（若有的話）。 (繼承來源 Reference) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
| JniPeerMembers |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
方法
| 名稱 | Description |
|---|---|
| Clear() |
清除這個參考物件。 (繼承來源 Reference) |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
| Enqueue() |
將此參考物件加入其註冊佇列（若有）。 (繼承來源 Reference) |
| Equals(Object) |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| Get() |
回傳此參考物件的指稱。 (繼承來源 Reference) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| RefersTo(Object) |
測試此參考物件的所指對象是否為 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
軟參考物件，這些物件會由垃圾回收器根據記憶體需求自行決定清除。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |