IDebugProperty2
Aplica-se a: Visual Studio
Visual Studio para Mac
Visual Studio Code
Essa interface representa uma propriedade de quadro de pilha, uma propriedade de documento de programa ou alguma outra propriedade. A propriedade geralmente é o resultado de uma avaliação de expressão.
Observação
Esse uso de "propriedade" não deve ser confundido com isso, o que significa uma variável de membro de uma classe, embora possa IDebugProperty2
representar tal entidade.
Syntax
IDebugProperty2 : IUnknown
Anotações para implementadores
O DE implementa essa interface para representar um tipo específico de valor. Por exemplo, o valor pode ser um valor numérico como resultado de uma avaliação de expressão, um contexto de memória usado para exibir memória ou uma lista de registros e seus valores.
Observações para chamadores
Chame EvaluateSync ou EvaluateAsync para obter essa interface, que representa o resultado de uma avaliação. IDebugExpression2::EvaluateAsync
retorna essa interface enviando uma interface IDebugExpressionEvaluationCompleteEvent2 para o SDM, que por sua vez chama GetResult para recuperar a propriedade.
GetDebugProperty retorna essa interface para fornecer o documento de script associado.
GetReturnValue retorna essa interface para representar o valor retornado de uma função.
GetDebugProperty retorna essa interface para representar várias propriedades do programa, como um nome ou um contexto de memória.
GetDebugProperty retorna essa interface para representar várias propriedades do quadro de pilha, como variáveis locais.
Métodos na Ordem Vtable
A tabela a seguir mostra os métodos de IDebugProperty2
.
Método | Descrição |
---|---|
Getpropertyinfo | Preenche uma estrutura DEBUG_PROPERTY_INFO que descreve uma propriedade. |
SetValueAsString | Define o valor de uma propriedade de uma cadeia de caracteres. |
SetValueAsReference | Define o valor da propriedade do valor de uma determinada referência. |
EnumChildren | Enumera os filhos de uma propriedade. |
GetParent | Retorna o pai de uma propriedade. |
GetDerivedMostProperty | Retorna a propriedade que descreve a propriedade mais derivada de uma propriedade. |
GetMemoryBytes | Retorna os bytes de memória que compõem o valor de uma propriedade. |
GetMemoryContext | Retorna o contexto de memória de um valor de propriedade. |
Getsize | Retorna o tamanho, em bytes, do valor da propriedade. |
Getreference | Retorna uma referência ao valor dessa propriedade. |
GetExtendedInfo | Retorna as informações estendidas de uma propriedade. |
Comentários
Uma propriedade, como representada por uma IDebugProperty2
interface, pode ser considerada como um valor com um nome, um tipo e um endereço. Em termos mais gerais, uma IDebugProperty2
pode representar qualquer coisa que tenha uma estrutura hierárquica, com nós de pais e filhos.
Uma propriedade geralmente é transitória, durando apenas o quadro de pilha atual, por exemplo. Por outro lado, uma referência, representada por uma interface IDebugReference2 , dura enquanto o valor permanecer na memória.
O IDE pode usar a IDebugProperty2
interface para permitir que os usuários naveguem e modifiquem as propriedades em tempo de execução.
Requisitos
Cabeçalho: msdbg.h
Namespace: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll