Compartilhar via


DkmEngineSettings Classe

Definição

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
DkmEngineSettings
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)

Aplica-se a