Compartilhar via


ICorDebugReferenceValue Interface

Fornece métodos que gerenciam um valor que é uma referência a um objeto. (Ou seja, essa interface fornece métodos que gerenciam um ponteiro.) Essa interface implementa "ICorDebugValue".

Methods

Método Description
Método de desreferência Obtém o objeto referenciado.
Método DereferenceStrong Não implementado. Não chame esse método.
Método GetValue Obtém o endereço de memória atual do objeto referenciado.
Método IsNull Obtém um valor que indica se esse ICorDebugReferenceValue é um valor nulo, nesse caso, o ICorDebugReferenceValue não aponta para um objeto.
Método SetValue Define o endereço de memória atual. Ou seja, esse método define isso ICorDebugReferenceValue para apontar para um objeto.

Observações

O CLR (Common Language Runtime) pode fazer uma coleta de lixo em objetos quando o processo depurado é continuado. A coleta de lixo pode mover objetos na memória. Um ICorDebugReferenceValue cooperará com a coleta de lixo para que suas informações sejam atualizadas após a coleta de lixo ou elas serão invalidadas implicitamente antes da coleta de lixo.

O ICorDebugReferenceValue objeto pode ser invalidado implicitamente após a continuação do processo depurado. O "ICorDebugHandleValue" derivado não é invalidado até que seja explicitamente liberado ou exposto.

Observação

Essa interface não dá suporte a ser chamada remotamente, seja entre máquinas ou entre processos.

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET: Disponível desde o .NET Framework 1.0