GCHandleType 列挙型
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
型が割り当てることができるハンドルの種類を GCHandle 表します。
public enum class GCHandleTypepublic enum GCHandleType[System.Serializable]
public enum GCHandleType[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum GCHandleTypetype GCHandleType = [<System.Serializable>]
type GCHandleType = [<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type GCHandleType = Public Enum GCHandleType- 継承
- 属性
| 名前 | 値 | 説明 |
|---|---|---|
| Normal | 2 | この種類のハンドルは、非透過ハンドルを表します。つまり、このハンドルを使用して、その中に格納されている固定化されたオブジェクトのアドレスを解決することはできません。 この種類のハンドルは、オブジェクトを追跡し、ガベージ コレクターによって収集されないようにするために使用できます。 マネージド オブジェクトへの、ガベージ コレクターが検出できない唯一の参照をアンマネージド クライアントが保持している場合、この列挙体メンバーを使用すると便利です。 |
| Pinned | 3 | この種類ハンドルは Normal に似ていますが、このハンドルを使用した場合は、固定オブジェクトのアドレスを取得できます。 これにより、ガベージ コレクターがそのオブジェクトを移動できなくなるため、ガベージ コレクターの効率は低下することになります。 割り当てられたハンドルをできる限り早く解放するには、Free() メソッドを使用します。 |
| Weak | 0 | この種類のハンドルはオブジェクトを追跡するために使用しますが、そのオブジェクトを収集できるようにもします。 オブジェクトが収集された場合、GCHandle インスタンスの内容は 0 に設定されます。
|
| WeakTrackResurrection | 1 | この種類のハンドルは Weak に似ていますが、ファイナライズ中にオブジェクトが復活された場合でも、このハンドルは 0 には設定されません。 |
| 製品 | バージョン |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。