DkmEngineSettings Класс

Определение

Пространство имен:

Microsoft.VisualStudio.Debugger

Сборка:

Microsoft.VisualStudio.Debugger.Engine.dll

Пакет:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Содержит параметры отладки на уровне сеанса. Существует один экземпляр этого объекта для каждого модуля GUID (например, один экземпляр для COMPlusOnlyEng2, один экземпляр для 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

Наследование

Object

DkmDataContainer

DkmEngineSettings

Атрибуты

GuidAttribute

Свойства

AllowOutOfProcessSymbolLoading	При значении true отладчик будет загружать собственные символы в отдельный процесс. Этот API появился в Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview).
BaseDebugMonitorId	Базовый монитор отладки, используемый этим обработчиком. Это значение может иметь значение Guid.Empty (GUID_NULL), если подсистема может использовать различные базовые мониторы отладки в зависимости от процесса отладки.
ClrDebuggingServicesId	Указывает, какая версия служб отладки CLR (mscordbi.dll или другая реализация API ICorDebug) должна использоваться при отладке этого процесса.
DataBreakpointAsString	Дескрипторы точек останова данных следует рассматривать как строки. Этот API появился в Visual Studio 16 RTM (DkmApiVersion.VS16RTM).
DotnetVisualizerExtensionInfos	[Необязательно] Содержит важные сведения о визуализаторах пользовательского отладчика .NET, которые были установлены с помощью пакетов VSIX и управляются диспетчером частей расширений. Этот API появился в Visual Studio 17 с обновлением 6 (DkmApiVersion.VS17Update6).
EnableAsyncDebugging	Включает пошаговое выполнение инструкций await и выход из асинхронных методов. Этот параметр включен по умолчанию.
EnableFuncEvalQuickAbort	Указывает, включена ли функция FEQA для этого модуля для этого сеанса отладки.
EngineId	Это "стандартные" значения GUID подсистемы. Ожидается, что этот список будет увеличиваться со временем, поэтому по возможности рекомендуется запрашивать параметр вместо сравнения EngineId.
Flags	Флаги, указывающие неизменяемые признаки параметров этого обработчика.
FuncEvalAbortLoggingLevel	Используется для указания того, следует ли создать дамп отладчика при прерывании или грубом прерывании функ- Этот API появился в Visual Studio 15 с обновлением 4 (DkmApiVersion.VS15Update4).
FuncEvalQuickAbortExcludeList	Список исполняемых файлов, для которых FEQA не включен, даже если загружены библиотеки DLL FEQA.
ImageDebugDirectoryFormats	Список поддерживаемых значений для IMAGE_DEBUG_DIRECTORY. Тип.
IsAutomaticDecompilationEnabled	Если значение равно true, модули могут быть декомпилированы автоматически, если сведения о символах недоступны из других источников. Этот API появился в Visual Studio 17 с обновлением 7 (DkmApiVersion.VS17Update7).
IsEditAndContinue	Включает "Изменить и продолжить". Этот API появился в Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
IsFastEvaluateAllowed	При значении true (состояние по умолчанию) инспектор СРЕДЫ CLR в некоторых случаях попытается интерпретировать простые свойства и методы, а не использовать func-eval. Более сложные методы по-прежнему будут оцениваться с помощью func-eval. Этот API появился в Visual Studio 16 с обновлением 2 (DkmApiVersion.VS16Update2).
IsGpuRaceHazardsAllowSameSettingEnabled	Если значение равно true, отладчик будет игнорировать риски гонки GPU, которые не изменили предыдущие данные.
IsJustMyCodeEnabled	При значении true отладчик включает функции JustMyCode (пошаговое выполнение, стек вызовов и фильтрацию исключений).
IsNativeExportsEnabled	При значении true отладчик попытается использовать таблицы экспорта из файлов Win32 PE для разрешения адресов.
IsNativeJustMyCodeSteppingEnabled	При значении true отладчик включает пошаговое выполнение только мой код для машинного кода (при компиляции модуля с параметром /JMC). Этот API появился в Visual Studio 15 с обновлением 8 (DkmApiVersion.VS15Update8).
IsStepOverPropertiesAndOperatorsEnabled	При значении true отладчик будет перешаговлить свойства и операторы по завершении шага.
IsSuppressOptimizationsEnabled	Если значение равно true, отладчик будет подавлять оптимизации JIT-компилятора для вновь загруженных модулей.
IsUnloaded	Возвращает значение true, если для этого объекта было вызвано событие "unloaded" (например, вызывается DkmThread::Unload) или если объект был закрыт. Обратите внимание, что при проверке этого состояния необходимо соблюдать осторожность, так как без синхронизации возвращаемое состояние может быть не точным после прочтения инструкции. (Унаследовано от DkmDataContainer)
Languages	Коллекция всех языков программирования, поддерживаемых при отладке этого процесса.
MaxCallStackFrames	Максимальное количество кадров, поддерживаемых в окне стека вызовов. Этот API появился в Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
NativeEESettings	[Необязательно] Содержит параметры конфигураций для собственного средства оценки выражений. Этот API появился в Visual Studio 17 с обновлением 7 (DkmApiVersion.VS17Update7).
RegistryTweaks	[Необязательно] Список настроек реестра в реестре Visual Studio, которые компоненты могут использовать для настройки своего поведения. Настройки реестра считываются из раздела [Корень реестра Visual Studio]\Debugger\EngineSwitches в начале каждого сеанса отладки. Этот API появился в Visual Studio 12 RTM (DkmApiVersion.VS12RTM).
RemoteClrPdbNamePatterns	Список шаблонов имен PDB, используемых для определения того, будет ли PDB загружаться на удаленной стороне.
RequireFullTrustForSourceServer	При значении true отладчик потребует, чтобы сборки были полностью доверенными перед выполнением команд исходного сервера из сборки. Концепция полного доверия применяется только к сборкам СРЕДЫ CLR.
SymbolPaths	Коллекция DkmStrings, представляющая пути поиска символов и путь к кэшу.
TraceSettings	[Необязательно] Параметры трассировки для выходных данных WPF. Этот API появился в Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
ValidateFilesForMinidumps	Значение true, если отладчик должен проверить цифровые подписи библиотек отладки CLR перед их загрузкой. Обратите внимание, что, несмотря на имя, этот параметр фактически используется для всех типов отладки. Этот API появился в Visual Studio 12 RTM (DkmApiVersion.VS12RTM).

Методы

FindProcess(Guid)	Найдите элемент DkmProcess в этом DkmEngineSettings. Если нет элемента с заданным входным ключом, findProcess завершится ошибкой.
FindSettings(Guid)	Найдите объект DkmEngineSettings. Если нет объекта с заданным входным ключом, findSettings завершится ошибкой.
GetCodeViewCompilers()	Возвращает перечисление значений DkmCodeViewCompilerId. Это перечисление может использоваться поставщиком символов для сопоставления сведений в записи представления кода со структурой DkmCompilerId.
GetCorDumpAdditionalClrRuntimePaths(ReadOnlyCollection<String>)	Получение дополнительных путей среды выполнения Clr. Этот API появился в Visual Studio 17 с обновлением 1 (DkmApiVersion.VS17Update1).
GetDataItem<T>()	Возвращает экземпляр T, который был добавлен в этот экземпляр контейнера. Если этот контейнер не содержит "T", эта функция возвращает значение NULL. (Унаследовано от DkmDataContainer)
GetLanguage(DkmCompilerId)	Возвращает объект DkmLanguage, соответствующий заданному идентификатору компилятора. Если язык неизвестен (не зарегистрирован в обработчике), этот метод вернет объект языка по умолчанию.
GetProcesses()	GetProcesses перечисляет элементы DkmProcess этого объекта DkmEngineSettings.
GetSettings()	GetSettings перечисляет все созданные объекты DkmEngineSettings.
GetUserDocumentPath()	Получите путь к папке visual studio пользовательского документа.
RemoveDataItem<T>()	Удалите экземпляр T из этого контейнера. Обычно не требуется вызывать этот метод, так как контейнер данных автоматически очищается при закрытии объекта. (Унаследовано от DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)	Поместите новый элемент в контейнер данных. (Унаследовано от DkmDataContainer)