GCHandleType 列挙体
アセンブリ: mscorlib (mscorlib.dll 内)

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

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

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。


- GCHandleType 列挙体のページへのリンク