IDebugProperty2IDebugProperty2

Essa interface representa uma propriedade de quadro de pilha, uma propriedade de documento do programa ou outra propriedade.This interface represents a stack frame property, a program document property, or some other property. A propriedade é geralmente o resultado de uma avaliação de expressão.The property is usually the result of an expression evaluation.

Note

Esse uso de "property" não deve ser confundido com esse que significa que uma variável de membro de uma classe, embora um IDebugProperty2 pode representar essa entidade.This use of "property" should not be confused with that meaning a member variable of a class, although an IDebugProperty2 can represent such an entity.

SintaxeSyntax

IDebugProperty2 : IUnknown

Observações para implementadoresNotes for Implementers

O DE implementa essa interface para representar um determinado tipo de valor.The DE implements this interface to represent a particular kind of value. 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 a memória ou uma lista de registros e seus valores.For example, the value could be a numerical value as a result of an expression evaluation, a memory context used for displaying memory, or a list of registers and their values.

Observações para chamadoresNotes for Callers

Chame EvaluateSync ou EvaluateAsync para obter essa interface, que representa o resultado de uma avaliação.Call EvaluateSync or EvaluateAsync to obtain this interface, which represents the result of an evaluation. IDebugExpression2::EvaluateAsync retorna essa interface, enviando uma IDebugExpressionEvaluationCompleteEvent2 interface para o SDM, que por sua vez chama GetResult ao recuperar a propriedade.IDebugExpression2::EvaluateAsync returns this interface by sending an IDebugExpressionEvaluationCompleteEvent2 interface to the SDM, which in turn calls GetResult to retrieve the property.

  • GetDebugProperty retorna essa interface para fornecer o documento de script associado.GetDebugProperty returns this interface to provide the associated script document.

  • GetReturnValue retorna essa interface para representar o valor de retorno de uma função.GetReturnValue returns this interface to represent the return value of a function.

  • GetDebugProperty retorna essa interface para representar várias propriedades do programa como um nome ou um contexto de memória.GetDebugProperty returns this interface to represent various properties of the program such as a name or a memory context.

  • GetDebugProperty retorna essa interface para representar várias propriedades do quadro de pilha, como variáveis locais.GetDebugProperty returns this interface to represent various properties of the stack frame such as local variables.

Métodos na ordem de VtableMethods in Vtable Order

A tabela a seguir mostra os métodos de IDebugProperty2.The following table shows the methods of IDebugProperty2.

MétodoMethod DescriçãoDescription
GetPropertyInfoGetPropertyInfo Preenche um DEBUG_PROPERTY_INFO estrutura que descreve uma propriedade.Fills in a DEBUG_PROPERTY_INFO structure that describes a property.
SetValueAsStringSetValueAsString Define o valor de uma propriedade de uma cadeia de caracteres.Sets the value of a property from a string.
SetValueAsReferenceSetValueAsReference Define o valor da propriedade do valor de uma determinada referência.Sets the value of the property from the value of a given reference.
EnumChildrenEnumChildren Enumera os filhos de uma propriedade.Enumerates the children of a property.
GetParentGetParent Retorna o pai de uma propriedade.Returns the parent of a property.
GetDerivedMostPropertyGetDerivedMostProperty Retorna a propriedade que descreve a propriedade mais derivado de uma propriedade.Returns the property that describes the most-derived property of a property.
GetMemoryBytesGetMemoryBytes Retorna os bytes de memória que compõem o valor de uma propriedade.Returns the memory bytes that compose the value of a property.
GetMemoryContextGetMemoryContext Retorna o contexto de memória para um valor da propriedade.Returns the memory context for a property value.
GetSizeGetSize Retorna o tamanho, em bytes, do valor da propriedade.Returns the size, in bytes, of the property value.
GetReferenceGetReference Retorna uma referência ao valor desta propriedade.Returns a reference to this property's value.
GetExtendedInfoGetExtendedInfo Retorna as informações estendidas de uma propriedade.Returns the extended information of a property.

ComentáriosRemarks

Uma propriedade, conforme representado por um IDebugProperty2 interface, pode ser pensada como um valor com um nome, um tipo e um endereço.A property, as represented by an IDebugProperty2 interface, can be thought of as a value with a name, a type, and an address. Em termos mais gerais, um IDebugProperty2 pode representar qualquer coisa que tem uma estrutura hierárquica, com os pais e nós filho.In more general terms, an IDebugProperty2 can represent anything that has a hierarchical structure, with parents and child nodes.

Uma propriedade é normalmente transitório, permanecendo apenas como o quadro de pilha atual, por exemplo.A property is usually transitory, lasting only as long as the current stack frame, for example. Por outro lado, uma referência, conforme representado por um IDebugReference2 interface dura desde que o valor permanece na memória.On the other hand, a reference, as represented by an IDebugReference2 interface, lasts as long as the value remains in memory.

O IDE pode usar o IDebugProperty2 interface para permitir aos usuários navegar e modificar propriedades em tempo de execução.The IDE can use the IDebugProperty2 interface to let users browse and modify properties at run time.

RequisitosRequirements

Header: msdbg.hHeader: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.InteropNamespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dllAssembly: Microsoft.VisualStudio.Debugger.Interop.dll

Consulte tambémSee also