Compartilhar via


DkmSuccessEvaluationResult Classe

Definição

O resultado formatado de uma avaliação bem-sucedida, pronto para ser exibido em uma janela de avaliação de expressão.

public ref class DkmSuccessEvaluationResult : Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationResult
[System.Runtime.InteropServices.Guid("5d948996-5805-1795-8b6b-535f0bc32bde")]
public class DkmSuccessEvaluationResult : Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationResult
[<System.Runtime.InteropServices.Guid("5d948996-5805-1795-8b6b-535f0bc32bde")>]
type DkmSuccessEvaluationResult = class
    inherit DkmEvaluationResult
Public Class DkmSuccessEvaluationResult
Inherits DkmEvaluationResult
Herança
Herança
DkmSuccessEvaluationResult
Atributos

Propriedades

Access

O nível de controle de acesso (público, privado etc.) do resultado da avaliação.

Address

[Opcional] Se o resultado for um endereço (ou seja, o sinalizador de endereço está definido em Sinalizadores), especificará o local do valor de suporte. Isso é usado quando o resultado da avaliação é usado como a entrada para a janela de memória ou a janela de desmontagem. Se for um endereço de instrução, ele deverá ter o endereço CPUInstruction definido.

Category

A categoria (por exemplo: Dados, Método etc.) desse resultado de avaliação.

CustomUIVisualizers

[Opcional] Uma lista de visualizadores personalizados para este objeto.

EditableValue

[Opcional] Se o valor for gravável, especificará a cadeia de caracteres padrão a ser usada quando você clicar duas vezes no valor para editá-lo. O EE deve ser capaz de analisar e avaliar essa cadeia de caracteres e obter de volta o resultado da avaliação atual. Se o valor for somente leitura, o valor editável será ignorado e deverá ser nulo.

ExternalModules

[Opcional] Se disponível, uma lista de módulos externos, sem incluir o módulo atual, que são usados para a inspeção do objeto. Carregar símbolos para o maior número possível de módulos nessa lista aprimorará a exibição do objeto.

Flags

Sinalizadores que indicam atributos de um resultado de avaliação de expressão.

FullName

[Opcional] O nome completo da expressão à qual este resultado se aplica. Esse valor é usado para permitir que elementos filho sejam adicionados à janela watch (Adicionar Inspeção no menu de contexto) e atualizar partes da árvore de avaliação. Como exemplo de como FullName difere do nome, o nome do 0º elemento de uma matriz em C++ é '[0]' enquanto o nome completo seria 'myArrayVariable[0]'. Para o Visual Studio 14 e posterior, é possível calcular o nome completo posteriormente, se necessário. Para fazer isso, o avaliador de expressão deve criar o DkmEvaluationResult com um nome completo nulo e implementar IDkmFullNameProvider. Concord chamará IDkmFullNameProvider.CalculateFullName para obter o nome completo quando necessário na interface do usuário.

(Herdado de DkmEvaluationResult)
InspectionContext

Contexto de inspeção usado para criar esse resultado de avaliação.

(Herdado de DkmEvaluationResult)
InspectionSession

A InspectionSession permite que os vários componentes que examinam dados no processo de destino armazenem dados privados com o mesmo tempo de vida. As sessões de inspeção são fechadas quando o usuário tenta continuar o processo.

(Herdado de DkmEvaluationResult)
IsUnloaded

Retornará true se um evento 'descarregado' tiver sido gerado para este objeto (exemplo: DkmThread::Unload for chamado) ou se o objeto tiver sido fechado. Observe que o cuidado deve ser usado ao verificar esse status, pois, sem sincronização, o status retornado pode não ser mais preciso após a leitura.

(Herdado de DkmDataContainer)
Language

Linguagem usada para realizar inspeções.

(Herdado de DkmEvaluationResult)
Name

O nome da expressão à qual este resultado se aplica.

(Herdado de DkmEvaluationResult)
RefreshButtonText

[Opcional] Quando DkmEvaluationResultFlags::CanEvaluateNow está definido, especifica o texto a ser exibido como uma dica de ferramenta quando o usuário passa o mouse sobre o botão de atualização. Se esse valor for nulo, uma mensagem padrão será usada.

Essa API foi introduzida no Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

RuntimeInstance

Indica qual monitor de runtime será usado para executar essa avaliação.

(Herdado de DkmEvaluationResult)
StackFrame

O registro de pilha em que esse resultado de expressão foi criado.

(Herdado de DkmEvaluationResult)
StorageType

O tipo de armazenamento (por exemplo: estático) do resultado da avaliação.

TagValue

DkmEvaluationResult é uma classe base abstrata. Essa enumeração indica de qual classe derivada esse objeto é uma instância do .

(Herdado de DkmEvaluationResult)
Type

[Opcional] Uma cadeia de caracteres que descreve o tipo do valor.

TypeModifierFlags

Sinalizadores modificador de tipo (ex: const) do resultado da avaliação.

UniqueId

Guid que identifica exclusivamente esse resultado de avaliação.

(Herdado de DkmEvaluationResult)
Value

[Opcional] Cadeia de caracteres que descreve o valor.

Métodos

AddToFavorites(DkmSuccessEvaluationResult)

Adiciona o filho especificado à coleção de itens favoritos no tipo desse resultado.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 16 Atualização 4 (DkmApiVersion.VS16Update4).

Close()

Fecha o objeto de resultado de avaliação para liberar os recursos associados a ele. Esse método deve ser invocado pelo componente que iniciou a enumeração (por exemplo: chamada DkmInspectionContext.EvaluateExpression, DkmEvaluationResultEnumContext.GetItems etc).

Os objetos DkmEvaluationResult são fechados automaticamente quando o objeto DkmInspectionSession associado é fechado.

(Herdado de DkmEvaluationResult)
Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmEvaluationResultFlags, String, String, String, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataAddress, ReadOnlyCollection<DkmCustomUIVisualizerInfo>, ReadOnlyCollection<DkmModuleInstance>, DkmDataItem)

Create uma nova instância de objeto DkmSuccessEvaluationResult.

Create(DkmInspectionContext, DkmStackWalkFrame, String, String, DkmEvaluationResultFlags, String, String, String, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, DkmDataAddress, ReadOnlyCollection<DkmCustomUIVisualizerInfo>, ReadOnlyCollection<DkmModuleInstance>, String, DkmDataItem)

Create uma nova instância de objeto DkmSuccessEvaluationResult.

Essa API foi introduzida no Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

CreateDebuggeeSideVisualizerObject(DkmWorkList, UInt32, DkmCompletionRoutine<DkmCreateDebuggeeSideVisualizerObjectAsyncResult>)

Cria uma instância do tipo visualizador personalizado do lado de depuração no processo de depuração.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 16 Atualização 10 (DkmApiVersion.VS16Update10).

CreateDebuggeeSideVisualizerObject(DkmWorkList, UInt32, Int32, DkmCompletionRoutine<DkmCreateDebuggeeSideVisualizerObject176AsyncResult>)

Cria uma instância do tipo visualizador personalizado do lado de depuração no processo de depuração e especifica o tipo de serialização que deve ser usado ao se comunicar com ele.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 17 Atualização 6 (DkmApiVersion.VS17Update6).

CreateDebuggeeSideVisualizerObject(UInt32, Int32, Int32, String, String, String, Boolean)

Cria uma instância do tipo visualizador personalizado do lado de depuração no processo de depuração e especifica o tipo de serialização que deve ser usado ao se comunicar com ele.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 17 Atualização 6 (DkmApiVersion.VS17Update6).

CreateDebuggeeSideVisualizerObject(UInt32, String, String, String)

Cria uma instância do tipo visualizador personalizado do lado de depuração no processo de depuração. Observação: esse método foi preterido em favor do definido na interface IDkmClrCustomVisualizerObjectProvider1610.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

CreateDebuggeeSideVisualizerObject(UInt32, String, String, String, Boolean)

Cria uma instância do tipo visualizador personalizado do lado de depuração no processo de depuração.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 16 Atualização 10 (DkmApiVersion.VS16Update10).

CreateObjectId()

Cria uma ID de objeto para essa expressão específica.

Restrição de local: os componentes do IDE podem chamar esse método independentemente do tipo de código que está sendo depurado. Atualmente, esse método também tem suporte para componentes de monitor de depuração, ao depurar o código em execução no CLR; no entanto, essa funcionalidade pode ser removida em uma versão futura.

(Herdado de DkmEvaluationResult)
CreateReplacementObjectOnDebuggeeSideVisualizer(Byte[], String, String, String)

Executa o método CreateReplacementObject(...) do tipo Visualizador Personalizado do lado de depuração e grava o resultado no identificador de objeto visualizado.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

DestroyDebuggeeSideVisualizerObject()

Libera o tipo de Visualizador Personalizado do lado de depuração no processo de depuração.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

DestroyDebuggeeSideVisualizerObject(DkmWorkList, DkmCompletionRoutine<DkmDestroyDebuggeeSideVisualizerObjectAsyncResult>)

Libera o tipo de Visualizador Personalizado do lado de depuração no processo de depuração.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

DestroyObjectId()

Destrói uma ID de objeto para essa expressão específica.

Restrição de local: os componentes do IDE podem chamar esse método independentemente do tipo de código que está sendo depurado. Atualmente, esse método também tem suporte para componentes de monitor de depuração, ao depurar o código em execução no CLR; no entanto, essa funcionalidade pode ser removida em uma versão futura.

(Herdado de DkmEvaluationResult)
ExtractFromProperty(IDebugProperty3)

Obtém o objeto DkmSuccessEvaluationResult que apoia o objeto IDebugProperty3. Essa API só funcionará corretamente do thread main do Visual Studio.

GetChildren(DkmWorkList, Int32, DkmInspectionContext, DkmCompletionRoutine<DkmGetChildrenAsyncResult>)

Obtém um contexto de enumeração usado para obter os filhos desse resultado de avaliação. Isso é usado em todas as janelas de avaliação de expressão.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: os componentes do IDE podem chamar esse método independentemente do tipo de código que está sendo depurado. Atualmente, esse método também tem suporte para componentes de monitor de depuração, ao depurar o código em execução no CLR; no entanto, essa funcionalidade pode ser removida em uma versão futura.

(Herdado de DkmEvaluationResult)
GetClrValue()

Obtém o DkmClrValue subjacente de um DkmSuccessEvaluationResult, se ele existir.

Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000).

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

GetDataBreakpointDisplayName()

Obtém o nome de exibição do ponto de interrupção de dados para o resultado da avaliação.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 16 RTM (DkmApiVersion.VS16RTM).

GetDataBreakpointDisplayName(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointDisplayNameAsyncResult>)

Obtém o nome de exibição do ponto de interrupção de dados para o resultado da avaliação.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 16 RTM (DkmApiVersion.VS16RTM).

GetDataBreakpointInfo(DkmWorkList, DkmCompletionRoutine<DkmGetDataBreakpointInfoAsyncResult>)

Retorna as informações de ponto de interrupção de dados relacionadas ao resultado da avaliação, se válido.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 15 Atualização 8 (DkmApiVersion.VS15Update8).

GetDataBreakpointInfo(String)

Retorna as informações de ponto de interrupção de dados relacionadas ao resultado da avaliação, se válido.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 15 Atualização 8 (DkmApiVersion.VS15Update8).

GetDataFromDebuggeeSideVisualizer(DkmWorkList, DkmCompletionRoutine<DkmGetDataFromDebuggeeSideVisualizerAsyncResult>)

Executa o método GetData(...) do tipo Debuggee-side Custom Visualizer.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

GetDataFromDebuggeeSideVisualizer(String, String, String)

Executa o método GetData(...) do tipo Debuggee-side Custom Visualizer.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

GetDataItem<T>()

Obtém a instância de 'T' que foi adicionada a essa instância de contêiner. Se esse contêiner não contiver um 'T', essa função retornará nulo.

(Herdado de DkmDataContainer)
GetUnderlyingString()

Esse método é usado para resultados de avaliação que incluem DkmEvaluationResultFlags.RawString para obter a cadeia de caracteres subjacente, sem aspas ou sequências de escape. Esse método é invocado para exibir um dos vários visualizadores de cadeia de caracteres em uma janela de avaliação de expressão (clique no ícone de lupa).

Restrição de local: os componentes do IDE podem chamar esse método independentemente do tipo de código que está sendo depurado. Atualmente, esse método também tem suporte para componentes de monitor de depuração, ao depurar o código em execução no CLR; no entanto, essa funcionalidade pode ser removida em uma versão futura.

(Herdado de DkmEvaluationResult)
RemoveDataItem<T>()

Remova a instância de 'T' desse contêiner. Geralmente, é desnecessário chamar esse método, pois um contêiner de dados será esvaziado automaticamente quando o objeto for fechado.

(Herdado de DkmDataContainer)
RemoveFromFavorites(DkmSuccessEvaluationResult)

Remove o filho especificado da coleção de itens favoritos no tipo desse resultado.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 16 Atualização 4 (DkmApiVersion.VS16Update4).

ResolveAssembly(String, String, ReadOnlyCollection<Byte>)

Resolve um nome de assembly para o caminho do assembly ou para seus bytes brutos.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

SetDataItem<T>(DkmDataCreationDisposition, T)

Coloque um novo item no contêiner de dados.

(Herdado de DkmDataContainer)
SetValueAsString(String, Int32, String)

Modifica o valor do resultado de avaliação fornecido (considerado não somente leitura) para corresponder à cadeia de caracteres fornecida. Isso é usado depois que o usuário edita um valor em qualquer uma das janelas de avaliação.

Restrição de local: os componentes do IDE podem chamar esse método independentemente do tipo de código que está sendo depurado. Atualmente, esse método também tem suporte para componentes de monitor de depuração, ao depurar o código em execução no CLR; no entanto, essa funcionalidade pode ser removida em uma versão futura.

(Herdado de DkmEvaluationResult)
TransferDataToDebuggeeSideVisualizer(Byte[], String, String, String)

Executa o método TransferData(...) do tipo Debuggee-side Custom Visualizer.

Restrição de local: a API deve ser chamada de um componente IDE (nível > de componente 100.000).

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

Implantações explícitas de interface

IDisposable.Dispose()

O resultado formatado de uma avaliação bem-sucedida, pronto para ser exibido em uma janela de avaliação de expressão.

(Herdado de DkmEvaluationResult)

Aplica-se a