GCHandleType 列挙体とは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

GCHandleType 列挙体

GCHandle クラスが割り当てることのできるハンドルの種類を表します。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Enumeration GCHandleType

Visual Basic (使用法)

Dim instance As GCHandleType

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum GCHandleType

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public enum class GCHandleType

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public enum GCHandleType

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public enum GCHandleType

メンバ

	メンバ名	説明
	Normal	この種類のハンドルは、非透過ハンドルを表します。つまり、このハンドルを使用して、その中に格納されている固定化されたオブジェクトのアドレスを解決することはできません。この種類のハンドルは、オブジェクトを追跡し、ガベージコレクタによって収集されないようにするために使用できます。マネージオブジェクトへの、ガベージコレクタが検出できない唯一の参照をアンマネージクライアントが保持している場合、この列挙体メンバを使用すると便利です。
	Pinned	この種類ハンドルは Normal に似ていますが、このハンドルを使用した場合は、固定オブジェクトのアドレスを取得できます。これにより、ガベージコレクタがそのオブジェクトを移動できなくなるため、ガベージコレクタの効率は低下することになります。割り当てられたハンドルをできる限り早く解放するには、Free メソッドを使用します。
	Weak	この種類のハンドルはオブジェクトを追跡するために使用しますが、そのオブジェクトを収集できるようにもします。オブジェクトが収集された場合、GCHandle インスタンスの内容は 0 に設定されます。Weak 参照はファイナライザの実行前に 0 に設定されるため、ファイナライザがそのオブジェクトを復活させた場合でも、Weak 参照は 0 のままになります。
	WeakTrackResurrection	この種類のハンドルは Weak に似ていますが、ファイナライズ中にオブジェクトが復活された場合でも、このハンドルは 0 には設定されません。