ICorDebugReferenceValue インターフェイス

[アーティクル]
08/09/2011

オブジェクトへの参照である値を管理するメソッドを提供します (つまり、このインターフェイスには、ポインターを管理するメソッドが用意されています)。このインターフェイスは、ICorDebugValue を実装します。

メソッド

メソッド	説明
ICorDebugReferenceValue::Dereference メソッド	参照されるオブジェクトを取得します。
ICorDebugReferenceValue::DereferenceStrong メソッド	実装されていません。このメソッドを呼び出さないでください。
ICorDebugReferenceValue::GetValue メソッド	参照されるオブジェクトの現在のメモリアドレスを取得します。
ICorDebugReferenceValue::IsNull メソッド	この ICorDebugReferenceValue が null 値かどうかを示す値を取得します。null 値の場合、ICorDebugReferenceValue はオブジェクトを指していません。
ICorDebugReferenceValue::SetValue メソッド	現在のメモリアドレスを設定します。つまり、このメソッドはこの ICorDebugReferenceValue がオブジェクトを指すように設定します。

解説

共通言語ランタイム (CLR: Common Language Runtime) は、デバッグされているプロセスを続行するときに、オブジェクトに対してガベージコレクションを実行する場合があります。ガベージコレクションはメモリ内でオブジェクトを移動できます。 ICorDebugReferenceValue は、ガベージコレクションの後に情報が更新されるようにガベージコレクションと連携するか、ガベージコレクションの前に暗黙的に無効化されます。

ICorDebugReferenceValue オブジェクトは、デバッグされているプロセスが続行された後、暗黙的に無効化される場合があります。派生した ICorDebugHandleValue は、明示的に解放または公開されるまで無効化されません。

メモ
このインターフェイスは、コンピューター間またはプロセス間でのリモート呼び出しをサポートしていません。