Compartilhar via


Interface ICorDebugReferenceValue

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".

Métodos

Método Descrição
Método Dereference 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 este 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, este método define este ICorDebugReferenceValue para apontar para um objeto.

Comentários

O Common Language Runtime (CLR) 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 serão invalidadas implicitamente antes da coleta de lixo.

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

Observação

Esta interface não pode ser chamada remotamente, seja entre computadores ou entre processos.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponíveis desde a versão 1.0

Confira também