ICorDebugReferenceValue 介面ICorDebugReferenceValue Interface

提供管理物件參考之值的方法。Provides methods that manage a value that is a reference to an object. (亦即,這個介面會提供管理指標的方法。 ) 此介面會實作為 "ICorDebugValue"。(That is, this interface provides methods that manage a pointer.) This interface implements "ICorDebugValue".

方法Methods

方法Method 描述Description
Dereference 方法Dereference Method 取得所參考的物件。Gets the object that is referenced.
DereferenceStrong 方法DereferenceStrong Method 未實作。Not implemented. 請不要呼叫此方法。Do not call this method.
GetValue 方法GetValue Method 取得所參考物件的目前記憶體位址。Gets the current memory address of the referenced object.
IsNull 方法IsNull Method 取得值,這個值會指出這是否 ICorDebugReferenceValue 為 null 值,在此情況下,不 ICorDebugReferenceValue 會指向物件。Gets a value that indicates whether this ICorDebugReferenceValue is a null value, in which case the ICorDebugReferenceValue does not point to an object.
SetValue 方法SetValue Method 設定目前的記憶體位址。Sets the current memory address. 也就是說,這個方法會將此設定 ICorDebugReferenceValue 為指向物件。That is, this method sets this ICorDebugReferenceValue to point to an object.

備註Remarks

當已調試的進程繼續時,common language runtime (CLR) 可能會對物件進行垃圾收集。The common language runtime (CLR) may do a garbage collection on objects when the debugged process is continued. 垃圾收集可能會在記憶體中移動物件。The garbage collection may move objects around in memory. ICorDebugReferenceValue會與垃圾收集合作,以便在垃圾收集之後更新其資訊,或在垃圾收集之前隱含地使其失效。An ICorDebugReferenceValue will either cooperate with the garbage collection so that its information is updated after the garbage collection, or it will be invalidated implicitly before the garbage collection.

ICorDebugReferenceValue 物件可能會在已繼續進行調試的進程之後隱含失效。The ICorDebugReferenceValue object may be implicitly invalidated after the debugged process has been continued. 衍生的 "ICorDebugHandleValue" 在明確釋放或公開之前不會失效。The derived "ICorDebugHandleValue" is not invalidated until it is explicitly released or exposed.

注意

這個介面不支援跨電腦或跨處理序的遠端呼叫。This interface does not support being called remotely, either cross-machine or cross-process.

規格需求Requirements

平台: 請參閱 系統需求Platforms: See System Requirements.

標頭: CorDebug.idl、CorDebug.hHeader: CorDebug.idl, CorDebug.h

程式庫: CorGuids.libLibrary: CorGuids.lib

.NET Framework 版本:自 1.0 起可用Available since 1.0.NET Framework Versions: 自 1.0 起可用Available since 1.0

另請參閱See also