PinnedGCHandle<T> 結構
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
代表一個強型別的 GC handle 到受管理物件。
generic <typename T>
where T : classpublic value class PinnedGCHandle : IDisposable, IEquatable<System::Runtime::InteropServices::PinnedGCHandle<T>>
public struct PinnedGCHandle<T> : IDisposable, IEquatable<System.Runtime.InteropServices.PinnedGCHandle<T>> where T : class
type PinnedGCHandle<'T (requires 'T : null)> = struct
interface IDisposable
Public Structure PinnedGCHandle(Of T)
Implements IDisposable, IEquatable(Of PinnedGCHandle(Of T))
類型參數
- T
追蹤到的物件 PinnedGCHandle<T> 類型。
- 繼承
- 實作
備註
物件被釘在 GC 堆積的固定位置,並允許其位址被取得。
此類型對應於 Pinned。
這種類型若使用不當將不安全。 不當使用,例如生命週期管理不善、提供無效的句柄值或同時處理,可能導致難以診斷的當機或資料損壞。
建構函式
| 名稱 | Description |
|---|---|
| PinnedGCHandle<T>(T) |
為指定物件分配一個句柄。 |
屬性
| 名稱 | Description |
|---|---|
| IsAllocated |
會獲得一個值,表示該句柄是否已被配置。 |
| Target |
取得或設定這個句柄所代表的物件。 |
方法
| 名稱 | Description |
|---|---|
| Dispose() |
執行與釋放、釋放或重設非受控資源相關聯的應用程式定義工作。 |
| Equals(Object) |
指出這個實例和指定的物件是否相等。 |
| Equals(PinnedGCHandle<T>) |
指出目前的物件是否等於相同類型的另一個物件。 |
| FromIntPtr(IntPtr) |
將從一個句柄建立的新物件回傳 PinnedGCHandle<T> 給一個受管理物件。 |
| GetAddressOfObjectData() |
取得物件資料在 PinnedGCHandle<T>. 中的位址。 |
| GetHashCode() |
傳回目前實例的哈希碼。 |
| ToIntPtr(PinnedGCHandle<T>) |
回傳物件的 PinnedGCHandle<T> 內部整數表示。 |