IDebugProperty2

Essa interface representa uma propriedade de quadro de pilha, uma propriedade de documento do programa ou outra propriedade. A propriedade geralmente é o resultado de uma avaliação de expressão.

Dica

Este uso de "propriedade" não deve ser confundido com aquele que significa uma variável de membro de uma classe, embora um IDebugProperty2 pode representar uma entidade inexistente.

IDebugProperty2 : IUnknown

Observações para Implementadores

O DE implementa essa interface para representar um determinado tipo de valor. Por exemplo, o valor poderia ser um valor numérico como resultado de uma avaliação de expressão, um contexto de memória usada para exibir a memória, ou uma lista de registradores e seus valores.

Observações para chamadores

Chame IDebugExpression2::EvaluateSync ou IDebugExpression2::EvaluateAsync para obter essa interface, que representa o resultado de uma avaliação. IDebugExpression2::EvaluateAsyncRetorna a essa interface, enviando uma IDebugExpressionEvaluationCompleteEvent2 interface para o SDM, que por sua vez chama IDebugExpressionEvaluationCompleteEvent2::GetResult para recuperar a propriedade.

IDebugPropertyCreateEvent2::GetDebugPropertyRetorna a esta interface para fornecer o documento de script associado.

IDebugReturnValueEvent2::GetReturnValueRetorna a esta interface para representar o valor de retorno de uma função.

IDebugProgram2::GetDebugPropertyRetorna a esta interface para representar as várias propriedades do programa, como um nome ou um contexto de memória.

IDebugStackFrame2::GetDebugPropertyRetorna a esta interface para representar diversas propriedades do quadro de pilha, como variáveis locais.

Métodos na ordem de Vtable

A tabela a seguir mostra os métodos de IDebugProperty2.

Método	Descrição
IDebugProperty2::GetPropertyInfo	Preenche uma DEBUG_PROPERTY_INFO estrutura que descreve uma propriedade.
IDebugProperty2::SetValueAsString	Define o valor de uma propriedade de uma string.
IDebugProperty2::SetValueAsReference	Define o valor da propriedade do valor de uma determinada referência.
IDebugProperty2::EnumChildren	Enumera os filhos de uma propriedade.
IDebugProperty2::GetParent	Retorna o pai de uma propriedade.
IDebugProperty2::GetDerivedMostProperty	Retorna a propriedade que descreve a propriedade derivado de mais de uma propriedade.
IDebugProperty2::GetMemoryBytes	Retorna os bytes de memória que compõem o valor de uma propriedade.
IDebugProperty2::GetMemoryContext	Retorna o contexto de memória para um valor de propriedade.
IDebugProperty2::GetSize	Retorna o tamanho, em bytes, do valor da propriedade.
IDebugProperty2::GetReference	Retorna uma referência ao valor desta propriedade.
IDebugProperty2::GetExtendedInfo	Retorna as informações estendidas de uma propriedade.

Comentários

Uma propriedade, conforme representado por um IDebugProperty2 interface, pode ser considerado como um valor com um nome, um tipo e um endereço. Em termos mais gerais, um IDebugProperty2 pode representar qualquer coisa que tenha uma estrutura hierárquica, com os pais e nós filho.

Uma propriedade é geralmente transitório, dura apenas contanto que o quadro de pilha atual, por exemplo. Por outro lado, uma referência, conforme representado por um IDebugReference2 interface dura, desde que o valor permanece na memória.

O IDE pode usar o IDebugProperty2 interface para permitir aos usuários procurar e modificar propriedades em tempo de execução.

Requisitos

Cabeçalho: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Consulte também

Referência

DEBUG_PROPERTY_INFO

IDebugReference2

Conceitos

Interfaces principais