DkmEngineSettings 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.
Contém as configurações de depuração em toda a sessão. Há uma instância desse objeto por Guid do mecanismo (por exemplo: uma instância para COMPlusOnlyEng2, uma instância para COMPlusNativeEng).
public ref class DkmEngineSettings : Microsoft::VisualStudio::Debugger::DkmDataContainer
[System.Runtime.InteropServices.Guid("3c1f22df-556c-18bf-7584-c2c649777bfe")]
public class DkmEngineSettings : Microsoft.VisualStudio.Debugger.DkmDataContainer
[<System.Runtime.InteropServices.Guid("3c1f22df-556c-18bf-7584-c2c649777bfe")>]
type DkmEngineSettings = class
inherit DkmDataContainer
Public Class DkmEngineSettings
Inherits DkmDataContainer
- Herança
- Herança
- Atributos
Propriedades
AllowOutOfProcessSymbolLoading |
Quando true, o depurador carregará símbolos nativos em um processo separado. Essa API foi introduzida no Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview). |
BaseDebugMonitorId |
Monitor de depuração base usado por esse mecanismo. Esse valor poderá ser Guid.Empty (GUID_NULL) se o mecanismo puder usar vários monitores de depuração base, dependendo do processo ser depurado. |
ClrDebuggingServicesId |
Indica qual versão dos serviços de depuração CLR (mscordbi.dll ou outra implementação da API ICorDebug) deve ser usada ao depurar esse processo. |
DataBreakpointAsString |
Se os descritores de pontos de interrupção de dados devem ser tratados como cadeias de caracteres. Essa API foi introduzida no Visual Studio 16 RTM (DkmApiVersion.VS16RTM). |
DotnetVisualizerExtensionInfos |
[Opcional] Contém informações relevantes sobre os visualizadores de depurador personalizados do .NET que foram instalados por meio de pacotes VSIX e são gerenciados pelo Gerenciador de Partes de Extensão. Essa API foi introduzida no Visual Studio 17 Atualização 6 (DkmApiVersion.VS17Update6). |
EnableAsyncDebugging |
Permite percorrer instruções 'await' e sair de métodos assíncronos. Isso está ativado por padrão. |
EnableFuncEvalQuickAbort |
Especifica se o FEQA está habilitado para esse mecanismo para esta sessão de depuração. |
EngineId |
Esses são os valores de GUID do mecanismo 'padrão'. Espera-se que essa lista cresça ao longo do tempo, portanto, sempre que possível, é recomendável consultar uma configuração em vez de comparar a EngineId. |
Flags |
Sinalizadores que indicam características imutáveis dessas configurações do mecanismo. |
FuncEvalAbortLoggingLevel |
Usado para indicar se é necessário criar um despejo do depurador quando uma avaliação func é anulada ou anulada rude. Essa API foi introduzida no Visual Studio 15 Atualização 4 (DkmApiVersion.VS15Update4). |
FuncEvalQuickAbortExcludeList |
Lista de executáveis para os quais o FEQA não está habilitado mesmo se as DLLs FEQA forem carregadas. |
ImageDebugDirectoryFormats |
Lista de valores com suporte para IMAGE_DEBUG_DIRECTORY. Tipo. |
IsAutomaticDecompilationEnabled |
Se for true, os módulos poderão ser descompilados automaticamente quando as informações de símbolo não estiverem disponíveis de outras fontes. Essa API foi introduzida no Visual Studio 17 Atualização 7 (DkmApiVersion.VS17Update7). |
IsEditAndContinue |
Habilita Editar e Continuar. Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
IsFastEvaluateAllowed |
Quando true (o estado padrão), o inspetor CLR tentará interpretar propriedades/métodos simples em alguns casos, em vez de usar func-eval. Métodos mais complicados ainda serão avaliados usando func-eval. Essa API foi introduzida no Visual Studio 16 Atualização 2 (DkmApiVersion.VS16Update2). |
IsGpuRaceHazardsAllowSameSettingEnabled |
Quando true, o depurador ignorará os riscos de corrida de GPU que não alteraram os dados anteriores. |
IsJustMyCodeEnabled |
Quando true, o depurador habilitará os recursos do JustMyCode (etapas, pilha de chamadas e filtragem de exceções). |
IsNativeExportsEnabled |
Quando true, o depurador tentará usar as tabelas de exportação de arquivos WIN32 PE para resolve endereços. |
IsNativeJustMyCodeSteppingEnabled |
Quando true, o depurador habilitará a etapa Just My Code para nativo (quando o módulo for compilado com a opção /JMC). Essa API foi introduzida no Visual Studio 15 Atualização 8 (DkmApiVersion.VS15Update8). |
IsStepOverPropertiesAndOperatorsEnabled |
Quando true, o depurador percorrerá as propriedades e os operadores quando uma etapa for concluída. |
IsSuppressOptimizationsEnabled |
Quando true, o depurador suprimirá otimizações do compilador Just-In-Time para módulos recém-carregados. |
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 como, sem sincronização, o status retornado pode não ser mais preciso após a leitura. (Herdado de DkmDataContainer) |
Languages |
Coleção de todas as linguagens de programação com suporte durante a depuração desse processo. |
MaxCallStackFrames |
O número máximo de quadros com suporte na janela de pilha de chamadas. Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
NativeEESettings |
[Opcional] Contém as configurações do avaliador de expressão nativa. Essa API foi introduzida no Visual Studio 17 Atualização 7 (DkmApiVersion.VS17Update7). |
RegistryTweaks |
[Opcional] Lista de ajustes do Registro no Registro do Visual Studio que os componentes podem usar para personalizar seu comportamento. Os ajustes do Registro são lidos da chave [Raiz do Registro do Visual Studio]\Depurador\EngineSwitches no início de cada sessão de depuração. Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
RemoteClrPdbNamePatterns |
Lista de padrões de nome PDB usados para determinar se o PDB será carregado no lado remoto. |
RequireFullTrustForSourceServer |
Quando true, o depurador exigirá que os assemblies sejam totalmente confiáveis antes de executar comandos de servidor de origem de um assembly. O conceito de totalmente confiável só se aplica a assemblies CLR. |
SymbolPaths |
Uma coleção de DkmStrings que representa os caminhos de pesquisa de símbolos e o caminho de cache. |
TraceSettings |
[Opcional] Configurações de rastreamento para saída do WPF. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM). |
ValidateFilesForMinidumps |
True se o depurador deve validar as assinaturas digitais das bibliotecas de depuração CLR antes de carregá-las. Observe que, apesar do nome, essa configuração é realmente usada para todos os tipos de depuração. Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion.VS12RTM). |
Métodos
FindProcess(Guid) |
Localize um elemento DkmProcess dentro deste DkmEngineSettings. Se nenhum elemento com a chave de entrada fornecida estiver presente, FindProcess falhará. |
FindSettings(Guid) |
Localize um objeto DkmEngineSettings. Se nenhum objeto com a chave de entrada fornecida estiver presente, FindSettings falhará. |
GetCodeViewCompilers() |
Retorna a enumeração de valores DkmCodeViewCompilerId. Essa enumeração pode então ser usada por um provedor de símbolos para mapear as informações dentro de um registro de exibição de código para a estrutura DkmCompilerId. |
GetCorDumpAdditionalClrRuntimePaths(ReadOnlyCollection<String>) |
Obtenha caminhos de runtime do Clr adicionais. Essa API foi introduzida no Visual Studio 17 Atualização 1 (DkmApiVersion.VS17Update1). |
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) |
GetLanguage(DkmCompilerId) |
Retorna o objeto DkmLanguage que corresponde à ID do compilador fornecida. Se o idioma for desconhecido (não registrado com o mecanismo), esse método retornará o objeto de linguagem padrão. |
GetProcesses() |
GetProcesses enumera os elementos DkmProcess deste objeto DkmEngineSettings. |
GetSettings() |
GetSettings enumera todos os objetos DkmEngineSettings criados. |
GetUserDocumentPath() |
Obtenha o caminho da pasta do Visual Studio do documento do usuário. |
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) |
SetDataItem<T>(DkmDataCreationDisposition, T) |
Coloque um novo item no contêiner de dados. (Herdado de DkmDataContainer) |