WeakReference 類別

定義

命名空間:

Java.Lang.Ref

組件:

Mono.Android.dll

弱式參考物件，不會防止其參考項成為可完成、完成，然後回收。

[Android.Runtime.Register("java/lang/ref/WeakReference", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "T" })]
public class WeakReference : Java.Lang.Ref.Reference

[<Android.Runtime.Register("java/lang/ref/WeakReference", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "T" })>]
type WeakReference = class
    inherit Reference

繼承

Object

JavaObject

Object

Reference

WeakReference

衍生

Org.Apache.Http.Impl.Conn.Tsccm.BasicPoolEntryRef

屬性

RegisterAttribute JavaTypeParametersAttribute

備註

弱式參考物件，不會防止其參考項成為可完成、完成，然後回收。 弱式參考最常用來實作標準化對應。

假設垃圾收集行程會在某個時間點判斷物件無法觸達。 屆時，它會以不可部分完成方式清除該物件的所有弱式參考，以及透過強式和軟式參考鏈結存取該物件之任何其他弱式可觸達物件的弱式參考。 同時，它會宣告所有先前弱式可觸達的物件都可以完成。 同時或稍後，它會將那些向參考佇列註冊的新清除弱式參考加入佇列。

已在1.2中新增。

的 java.lang.ref.WeakReferenceJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

名稱	Description
WeakReference(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。
WeakReference(Object, ReferenceQueue)	建立參考指定物件的新弱式參考，並且向指定的佇列註冊。
WeakReference(Object)	建立參考指定物件的新弱式參考。

屬性

名稱	Description
Class	傳回這個 Object的運行時間類別。 (繼承來源 Object)
Handle	基礎Android實例的句柄。 (繼承來源 Object)
IsEnqueued	測試這個參考物件是否在其相關聯的佇列中，如果有的話。 (繼承來源 Reference)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	弱式參考物件，不會防止其參考項成為可完成、完成，然後回收。 (繼承來源 JavaObject)
JniPeerMembers	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。
ThresholdType	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。

方法

名稱	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)	測試這個參考物件的參考是否為 obj。 (繼承來源 Reference)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	弱式參考物件，不會防止其參考項成為可完成、完成，然後回收。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</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)	取得實例 self類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	弱式參考物件，不會防止其參考項成為可完成、完成，然後回收。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制self輸入 TResult，檢查 強制在 Java 端是否有效。