DkmSuccessEvaluationResult Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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) |