語言

WeakGCHandle<T> 結構

定義

代表一個強型別的 GC handle 到受管理物件。

generic <typename T>
 where T : classpublic value class WeakGCHandle : IDisposable, IEquatable<System::Runtime::InteropServices::WeakGCHandle<T>>
public struct WeakGCHandle<T> : IDisposable, IEquatable<System.Runtime.InteropServices.WeakGCHandle<T>> where T : class
type WeakGCHandle<'T (requires 'T : null)> = struct
    interface IDisposable
Public Structure WeakGCHandle(Of T)
Implements IDisposable, IEquatable(Of WeakGCHandle(Of T))

類型參數

T

追蹤到的物件 WeakGCHandle<T> 類型。

繼承
WeakGCHandle<T>
實作

備註

該物品被允許被收集。 當物件被收集時,把柄目標設定為 null。

此類型對應於 Weak 或 WeakTrackResurrection。

這種類型若使用不當將不安全。 不當使用,例如生命週期管理不善、提供無效的句柄值,或同時處理,可能導致難以診斷的當機或資料損壞。

.

建構函式

名稱 Description
WeakGCHandle<T>(T, Boolean)

初始化 WeakGCHandle<T> 的新執行個體。

屬性

名稱 Description
IsAllocated

會獲得一個值,表示該句柄是否已被配置。

方法

名稱 Description
Dispose()

執行與釋放、釋放或重設非受控資源相關聯的應用程式定義工作。

Equals(Object)

指出這個實例和指定的物件是否相等。

Equals(WeakGCHandle<T>)

指出目前的物件是否等於相同類型的另一個物件。

FromIntPtr(IntPtr)

將從一個句柄建立的新物件回傳 WeakGCHandle<T> 給一個受管理物件。

GetHashCode()

傳回目前實例的哈希碼。

SetTarget(T)

設定這個 handle 所代表的物件。

ToIntPtr(WeakGCHandle<T>)

回傳物件的 WeakGCHandle<T> 內部整數表示。

TryGetTarget(T)

嘗試擷取目前物件所參考 WeakGCHandle<T> 的目標物件。

適用於

另請參閱