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	指示在调试此过程时应使用 ICorDebug API) (mscordbi.dll 或其他实现的 CLR 调试服务版本。
DataBreakpointAsString	如果数据断点描述符应被视为字符串。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTM) 中引入的。
DotnetVisualizerExtensionInfos	[可选]保存有关通过 VSIX 包安装并由扩展部件管理器管理的 .NET 自定义调试器可视化工具的相关信息。 此 API 是在 Visual Studio 17 Update 6 (DkmApiVersion.VS17Update6) 中引入的。
EnableAsyncDebugging	启用单步执行“await”语句和单步执行异步方法。 默认情况下，此选项处于打开状态。
EnableFuncEvalQuickAbort	指定是否为此调试会话的此引擎启用 FEQA。
EngineId	这些是“标准”引擎 GUID 值。 预计此列表会随着时间的推移而增长，因此，如果可能，建议查询设置，而不是比较 EngineId。
Flags	指示此引擎设置的不可变特征的标志。
FuncEvalAbortLoggingLevel	用于指示在 func eval 中止或粗鲁中止时是创建调试对象的转储。 此 API 是在 Visual Studio 15 Update 4 (DkmApiVersion.VS15Update4) 中引入的。
FuncEvalQuickAbortExcludeList	即使加载了 FEQA DLL，也不会为其启用 FEQA 的可执行文件的列表。
ImageDebugDirectoryFormats	IMAGE_DEBUG_DIRECTORY支持的值列表。类型。
IsAutomaticDecompilationEnabled	如果为 true，则当符号信息从其他源不可用时，模块可能会被自动反编译。 此 API 是在 Visual Studio 17 Update 7 (DkmApiVersion.VS17Update7) 中引入的。
IsEditAndContinue	启用“编辑并继续”。 此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 中引入的。
IsFastEvaluateAllowed	当 true (默认状态) 时，CLR 检查器将尝试在某些情况下解释简单的属性/方法，而不是使用 func-eval。 更复杂的方法仍将使用 func-eval 进行评估。 此 API 是在 Visual Studio 16 Update 2 (DkmApiVersion.VS16Update2) 中引入的。
IsGpuRaceHazardsAllowSameSettingEnabled	如果为 true，调试器将忽略未更改先前数据的 GPU 争用危害。
IsJustMyCodeEnabled	如果为 true，调试器将启用 JustMyCode 功能， (单步执行、调用堆栈和异常筛选) 。
IsNativeExportsEnabled	如果为 true，调试器将尝试使用 Win32 PE 文件中的导出表来解析地址。
IsNativeJustMyCodeSteppingEnabled	如果为 true，则使用 /JMC 开关) 编译模块时，调试器将为本机 (启用“仅我的代码”单步执行。 此 API 是在 Visual Studio 15 Update 8 (DkmApiVersion.VS15Update8) 中引入的。
IsStepOverPropertiesAndOperatorsEnabled	如果为 true，调试器将在执行单步执行时单步执行属性和运算符。
IsSuppressOptimizationsEnabled	如果为 true，调试器将禁止对新加载的模块进行实时编译器优化。
IsUnloaded	如果已为此对象引发“unloaded”事件，则返回 true (示例：DkmThread：：Unload) 或对象已关闭。 请注意，检查此状态时必须小心，因为如果不进行同步，则返回的状态在读取指令后可能不再准确。 (继承自 DkmDataContainer)
Languages	调试此过程时支持的所有编程语言的集合。
MaxCallStackFrames	调用堆栈窗口中支持的最大帧数。 此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 中引入的。
NativeEESettings	[可选]包含本机表达式计算器的配置设置。 此 API 是在 Visual Studio 17 Update 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	如果调试器应在加载 CLR 调试库之前验证其数字签名，则其值为 True。 请注意，尽管名称为 ，但此设置实际上用于所有类型的调试。 此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 中引入的。

方法

FindProcess(Guid)	在此 DkmEngineSettings 中查找 DkmProcess 元素。 如果不存在具有给定输入键的元素，FindProcess 将失败。
FindSettings(Guid)	查找 DkmEngineSettings 对象。 如果不存在具有给定输入键的对象，FindSettings 将失败。
GetCodeViewCompilers()	返回 DkmCodeViewCompilerId 值的枚举。 然后，符号提供程序可以使用此枚举将代码视图记录内的信息映射到 DkmCompilerId 结构。
GetCorDumpAdditionalClrRuntimePaths(ReadOnlyCollection<String>)	获取其他 Clr 运行时路径。 此 API 是在 Visual Studio 17 Update 1 (DkmApiVersion.VS17Update1) 中引入的。
GetDataItem<T>()	获取已添加到此容器实例的“T”实例。 如果此容器不包含“T”，则此函数将返回 null。 (继承自 DkmDataContainer)
GetLanguage(DkmCompilerId)	返回与给定编译器 ID 匹配的 DkmLanguage 对象。如果语言未知 (未注册到引擎) ，则此方法将返回默认语言对象。
GetProcesses()	GetProcesses 枚举此 DkmEngineSettings 对象的 DkmProcess 元素。
GetSettings()	GetSettings 枚举所有创建的 DkmEngineSettings 对象。
GetUserDocumentPath()	获取用户文档 visual studio 文件夹路径。
RemoveDataItem<T>()	从此容器中删除“T”的实例。 通常不需要调用此方法，因为数据容器将在对象关闭时自动清空。 (继承自 DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)	将新项放在数据容器中。 (继承自 DkmDataContainer)