WeakGCHandle<T> 結構
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表一個強型別的 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> 類型。
- 繼承
- 實作
備註
該物品被允許被收集。 當物件被收集時,把柄目標設定為 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> 的目標物件。 |