DkmInspectionContext Classe

Definição

Namespace:

Microsoft.VisualStudio.Debugger.Evaluation

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Pacote:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Opções e contexto de destino a serem usados durante a execução da operação de inspeção.

public ref class DkmInspectionContext

[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmInspectionContext

[Windows::Foundation::Metadata::WebHostHidden]
class DkmInspectionContext

[System.Runtime.InteropServices.Guid("0807c826-3338-dd99-2f3a-202ba8fb9da7")]
public class DkmInspectionContext

[<System.Runtime.InteropServices.Guid("0807c826-3338-dd99-2f3a-202ba8fb9da7")>]
type DkmInspectionContext = class

Public Class DkmInspectionContext

Herança

Object

DkmInspectionContext

Atributos

GuidAttribute

Propriedades

AdditionalVisualizationData	[Opcional] Especifica uma lista opcional de caminhos completos para arquivos de visualização a serem usados, além dos arquivos padrão do diretório de perfil de usuários e do diretório de instalação do Visual Studio. A precedência entre visualizadores conflitantes nesses caminhos, em relação aos caminhos padrão, é resolvida de acordo com as informações especificadas em 'AdditionalVisualizationDataPriority'. Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
AdditionalVisualizationDataPriority	Se AdditionalVisualizationData for especificado, especificará a prioridade desses dados em relação aos locais de pesquisa padrão. Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
EvaluationFlags	Sinalizadores que afetam como uma expressão de entrada deve ser analisada, compilada ou exibida.
FuncEvalFlags	Sinalizadores que afetam como as solicitações de avaliação de função são executadas.
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.
Language	Linguagem usada para realizar inspeções.
Radix	O radix a ser usado ao formatar dados inteiros. Atualmente, os valores com suporte são '16' e '10'.
ReturnValue	[Opcional] Preterido – não use. Em vez disso, os componentes devem usar a propriedade ReturnValues como a lista de todos os valores retornados e definir $ReturnValue para representar o último item de valor retornado na lista.
ReturnValues	[Opcional] Representação bruta de valores para $ReturnValue 1, $ReturnValue 2 etc. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
RuntimeInstance	Indica qual monitor de runtime será usado para executar essa avaliação.
SymbolsConnection	[Opcional] Se não for nulo, isso especificará uma conexão com um processo de trabalho em que os símbolos dessa operação de inspeção são processados. Isso será nulo se os símbolos forem carregados no processo IDE ou se forem carregados no depurador remoto (DkmModule.Connection não é nulo). Essa API foi introduzida no Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
Thread	O thread que está sendo examinado.
Timeout	Esse é o tempo limite a ser usado para operações potencialmente lentas, como uma avaliação de função. Esse valor é em milissegundos.

Métodos

ClrExpressionMayRequireParentheses(String)	Retorna true se a expressão pode exigir parênteses quando usada como uma subexpressão no idioma. 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 15 RTM (DkmApiVersion.VS15RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue)	Create uma nova instância de objeto DkmInspectionContext.
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority)	Create uma nova instância de objeto DkmInspectionContext. Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>)	Create uma nova instância de objeto DkmInspectionContext. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Create(DkmInspectionSession, DkmRuntimeInstance, DkmThread, UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32, DkmLanguage, DkmRawReturnValue, DkmCompiledVisualizationData, DkmCompiledVisualizationDataPriority, ReadOnlyCollection<DkmRawReturnValueContainer>, DkmWorkerProcessConnection)	Create uma nova instância de objeto DkmInspectionContext. Essa API foi introduzida no Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
EvaluateExpression(DkmWorkList, DkmLanguageExpression, DkmStackWalkFrame, DkmCompletionRoutine<DkmEvaluateExpressionAsyncResult>)	Associe a expressão de entrada e avalie-a. Em seguida, formate o valor resultante para exibição no depurador. Isso é usado para dicas de dados, as janelas watch, a janela imediata etc. 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.
EvaluateExpressionOnThreads(DkmWorkList, ReadOnlyCollection<UInt64>, DkmStackWalkFrame, DkmLanguageExpression, DkmCompletionRoutine<DkmEvaluateExpressionOnThreadsAsyncResult>)	Associe a expressão de entrada e avalie-a. Em seguida, formate o valor resultante para exibição no depurador. Isso é usado para dicas de dados, as janelas watch, a janela imediata etc. 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).
EvaluateReturnValue(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValue, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult>)	Avalia e formata um determinado DkmRawReturnValue usando apenas os dados fornecidos. 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).
EvaluateReturnValue2(DkmWorkList, DkmStackWalkFrame, DkmRawReturnValueContainer, DkmCompletionRoutine<DkmEvaluateReturnValueAsyncResult2>)	Avalia e formata um determinado DkmRawReturnValue usando apenas os dados fornecidos. 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).
GetClrArrayIndexExpression(String[])	Obter uma expressão de índice de matriz. 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 15 RTM (DkmApiVersion.VS15RTM).
GetClrCastExpression(String, DkmClrType, DkmClrCustomTypeInfo, DkmClrCastExpressionOptions)	Obter uma expressão de conversão, se a sintaxe válida. 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 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionAndFormatSpecifiers(String, ReadOnlyCollection<String>)	Divide a cadeia de caracteres nas partes do especificador de expressão e formato. 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 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionForNull()	Obtenha a expressão específica do idioma para nulo (palavra-chave). 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 15 RTM (DkmApiVersion.VS15RTM).
GetClrExpressionForThis()	Obtenha a expressão específica da linguagem para este/Eu. 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 15 RTM (DkmApiVersion.VS15RTM).
GetClrLocalVariableQuery(DkmClrInstructionAddress, Boolean)	Obtenha um DkmCompiledClrLocalsQuery para permitir a exibição de variáveis locais. 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).
GetClrMemberName(String, DkmClrType, DkmClrCustomTypeInfo, String, Boolean, Boolean)	Obtenha uma expressão de acesso de membro, se ela puder ser representada como sintaxe válida. 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 15 RTM (DkmApiVersion.VS15RTM).
GetClrNameForField(DkmClrModuleInstance, Int32)	Obtenha o nome específico do idioma para um identificador de metadados. 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 16 Atualização 10 (DkmApiVersion.VS16Update10).
GetClrNameForLocalVariable(DkmClrModuleInstance, DkmClrMethodId, DkmILRange, DkmClrLocalVariable)	Obtenha o nome específico do idioma para um identificador de metadados. 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 16 Atualização 10 (DkmApiVersion.VS16Update10).
GetClrObjectCreationExpression(DkmClrType, DkmClrCustomTypeInfo, String[])	Obtenha uma expressão de criação de objeto, se houver uma sintaxe válida. 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 15 RTM (DkmApiVersion.VS15RTM).
GetClrTypeName(DkmClrType, DkmClrCustomTypeInfo)	Obtenha o nome do tipo em um formulário válido no idioma, se a sintaxe válida. Esse método serve para construir nomes completos válidos com a capacidade de escapar/retornar nulo se não houver uma sintaxe válida. 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 15 RTM (DkmApiVersion.VS15RTM).
GetClrValidIdentifier(String)	Obtenha o identificador em um formulário válido no idioma. 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 15 RTM (DkmApiVersion.VS15RTM).
GetFrameArguments(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameArgumentsAsyncResult>)	Fornece informações sobre os argumentos de um registro de pilha. Atualmente, isso só é exposto por meio do modelo de automação do VS (EnvDTE.StackFrame.Arguments). 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.
GetFrameLocals(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameLocalsAsyncResult>)	Obtém um contexto de enumeração usado para obter as variáveis locais desse quadro de pilha. Isso é usado na computação da janela locais. 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.
GetFrameName(DkmWorkList, DkmStackWalkFrame, DkmVariableInfoFlags, DkmCompletionRoutine<DkmGetFrameNameAsyncResult>)	Fornece uma representação de texto para um quadro de pilha. Isso é usado ao criar a pilha de chamadas formatada. 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.
GetFrameReturnType(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetFrameReturnTypeAsyncResult>)	Fornece uma representação de texto do tipo de retorno para um ou mais quadros de pilha. Atualmente, isso só é exposto por meio do modelo de automação do VS (EnvDTE.StackFrame.ReturnType). 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).
GetTypeName(DkmClrType, DkmClrCustomTypeInfo, ReadOnlyCollection<String>)	Obtém a cadeia de caracteres de nome de tipo a ser exibida na interface do usuário para o DkmClrType fornecido. Esse método sempre retornará um valor e será usado em janelas de inspeção variável. 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).
WithProperties(UInt32, DkmEvaluationFlags, DkmFuncEvalFlags, UInt32)	Cria uma cópia do DkmInspectionContext original com as propriedades fornecidas atualizadas, como EvaluationFlags ou Radix. As propriedades são uma substituição completa dos originais e não serão mescladas nas propriedades originais. Portanto, todas as propriedades desejadas do DkmInspectionContext original devem ser fornecidas a esse método. Essa API foi introduzida no Visual Studio 17 Atualização 8 (DkmApiVersion.VS17Update8).