大网数据广告活动
.NET 与 C# 开发

使用托管调试助手诊断错误

· 52CE 我爱测

托管调试助手 (MDA) 是调试辅助程序,它与公共语言运行时 (CLR) 一起工作以提供关于运行时状态的信息。 这些助手可生成关于你无法通过其他方式捕获的运行时事件的信息性消息。 可以使用 MDA 隔离在托管代码和非托管代码之间转换时发生的、难以发现的应用程序 Bug。

托管调试助手 (MDA) 是调试辅助程序,它与公共语言运行时 (CLR) 一起工作以提供关于运行时状态的信息。 这些助手可生成关于你无法通过其他方式捕获的运行时事件的信息性消息。 可以使用 MDA 隔离在托管代码和非托管代码之间转换时发生的、难以发现的应用程序 Bug。

你可以启用或禁用通过添加到 Windows 注册表项或通过设置环境变量的所有 Mda。 可使用应用程序配置设置来启用特定的 MDA。 可以在应用程序的配置文件中为某些单独的 MDA 设置其他配置设置。 由于将在加载运行时后分析这些配置文件,因此必须在托管应用程序启动之前启用 MDA。 不能为已经启动的应用程序启用 MDA。

下表列出了使用.NET Framework 附带的 Mda:

asynchronousThreadAbort bindingFailure
callbackOnCollectedDelegate contextSwitchDeadlock
dangerousThreadingAPI dateTimeInvalidLocalFormat
dirtyCastAndCallOnInterface disconnectedContext
dllMainReturnsFalse exceptionSwallowedOnCallFromCom
failedQI fatalExecutionEngineError
gcManagedToUnmanaged gcUnmanagedToManaged
illegalPrepareConstrainedRegion invalidApartmentStateChange
invalidCERCall invalidFunctionPointerInDelegate
invalidGCHandleCookie invalidIUnknown
invalidMemberDeclaration invalidOverlappedToPinvoke
invalidVariant jitCompilationStart
loaderLock loadFromContext
marshalCleanupError marshaling
memberInfoCacheCreation moduloObjectHashcode
nonComVisibleBaseClass notMarshalable
openGenericCERCall overlappedFreeError
pInvokeLog pInvokeStackImbalance
raceOnRCWCleanup reentrancy
releaseHandleFailed reportAvOnComRelease
streamWriterBufferedDataLost virtualCERCall

默认情况下,.NET Framework 会为所有托管调试器激活 MDA 的子集。 可以查看通过选择 Visual Studio 中设置的默认Windows > 异常设置上调试菜单,然后展开托管调试助手列表。

在 Visual Studio 中的异常设置窗口

启用和禁用 Mda

可使用注册表项、环境变量和应用程序配置设置,启用和禁用 MDA。 若要使用应用程序配置设置,必须启用注册表项或环境变量。

Tip: 而不是禁用 Mda,可防止 Visual Studio 时收到 MDA 通知时显示 MDA 对话框。 为此,请选择Windows > 异常设置上调试菜单中,展开托管调试助手列表,然后选择或清除中断时引发为单个 MDA 的复选框。

注册表项

若要启用 Mda,请添加HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\。NETFramework\MDA Windows 注册表中的子项 (类型为 REG_SZ,值为 1)。 将下面的示例复制到一个名为文本文件MDAEnable.reg。打开 Windows 注册表编辑器 (RegEdit.exe),并从文件菜单中,选择导入。 选择MDAEnable.reg文件以在该计算机上启用 Mda。 将子项设置为字符串值1 (不是 DWORD 值的1) 使读取 MDA 设置从ApplicationName.suffix。 文件。 例如,Notepad 的 MDA 配置文件将被命名为 notepad.exe.mda.config。

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework]
"MDA"="1"

如果计算机在 64 位操作系统上运行 32 位应用程序,应按下方所示设置 MDA 密钥:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework]
"MDA"="1"

请参阅特定于应用程序的配置设置有关详细信息。 可以使用 COMPLUS_MDA 环境变量重写注册表设置。 请参阅环境变量有关详细信息。

若要禁用 Mda,请将 MDA 子项设置为0 (零) 使用 Windows 注册表编辑器。

默认情况下,即使未添加该注册表项,有些 MDA 也会在运行附加到调试器的应用程序时启用。 您可以通过运行禁用这些助手MDADisable.reg文件中,如在本部分中前面所述。

环境变量

还可以通过环境变量 COMPLUS_MDA 控制 MDA 激活,此变量可重写注册表项。 COMPLUS_MDA 字符串是一个区分大小写、以分号分隔的 MDA 名称列表或其他特殊控制字符串。 在托管或非托管调试器下启动将默认启用一组 MDA。 这是通过在环境变量或注册表项的值前面,隐式附加默认在调试器下启用的、以分号分隔的 MDA 的列表来实现的。 特殊控制字符串如下所示:

  • 0 - 停用所有 MDA。

  • 1 - 从 ApplicationName.mda.configg 读取 MDA 设置。

  • managedDebugger - 显式激活在调试器下启动托管可执行文件时隐式激活的所有 MDA。

  • unmanagedDebugger - 显式激活在调试器下启动非托管可执行文件时隐式激活的所有 MDA。

如果存在冲突的设置,则最新的设置将重写先前的设置:

  • COMPLUS_MDA=0 禁用所有 MDA,包括那些在调试器下隐式启用的 MDA。

  • 除了调试器下隐式启用的所有 MDA,COMPLUS_MDA=gcUnmanagedToManaged 还启用 gcUnmanagedToManaged。

  • COMPLUS_MDA=0;gcUnmanagedToManaged 启用 gcUnmanagedToManaged,但是禁用将在调试器下隐式启用的 MDA。

特定于应用程序的配置设置

可以在应用程序的 MDA 配置文件中单独地启用、禁用和配置某些助手。 若要使用用于配置 MDA 的应用程序配置文件,必须设置 MDA 注册表项或 COMPLUS_MDA 环境变量。 应用程序配置文件通常与应用程序的可执行文件 (.exe) 位于同一目录中。 文件名采用“ApplicationName.mda.config”形式;例如,notepad.exe.mda.config。在应用程序配置文件中启用的助手可能包含专门设计用于控制该助手的行为的特性或元素。

下面的示例演示如何启用和配置封送处理:

<mdaConfig>
  <assistants>
    <marshaling>
      <methodFilter>
        <match name="*"/>
      </methodFilter>
      <fieldFilter>
        <match name="*"/>
      </fieldFilter>
    </marshaling>
  </assistants>
</mdaConfig>

对于应用程序中每个托管到非托管的转换,Marshaling MDA 会发出有关正封送到非托管类型的托管类型信息。 Marshaling MDA 还可以筛选的方法的名称,并按提供的结构字段methodFilter并fieldFilter子元素分别。

下面的示例演示如何使用其默认设置启用多个 Mda:

<mdaConfig>
  <assistants>
    <illegalPrepareConstrainedRegion />
    <invalidCERCall />
    <openGenericCERCall />
    <virtualCERCall />
  </assistants>
</mdaConfig>

Important: 若在配置文件中指定了多个助手,则必须按字母顺序列出这些助手。 例如,若要同时启用 virtualCERCall 和 invalidCERCall MDA,则必须先添加 <invalidCERCall /> 项,再添加 <virtualCERCall /> 项。 如果这些项未按字母顺序排列,将显示未处理的无效配置文件异常消息。

MDA 异常

启用 MDA 后,它处于活动状态甚至当你的代码是不在调试器下执行。 如果在调试器不存在时引发 MDA 事件,尽管这不是未经处理的异常,事件消息也会出现在未经处理的异常对话框中。 若要避免出现该对话框,请在代码未在调试环境中执行时,移除 MDA 启用设置。

当你的代码执行在 Visual Studio 集成的开发环境 (IDE) 中时,可以避免针对特定 MDA 事件出现的异常对话框。 为此,请在调试菜单中,选择Windows > 异常设置。 在中异常设置窗口中,展开托管调试助手列表中,,然后清除中断时引发为单个 MDA 的复选框。 此外可以使用此对话框启用MDA 异常对话框的显示。

MDA 输出

MDA 输出结果类似于下面的示例,其中显示了从输出PInvokeStackImbalanceMDA:

PInvoke 函数的调用 MDATest !MDATest.Program::StdCall 具有使堆栈不平衡。这可能是因为托管的 PInvoke 签名与非托管的目标签名不匹配。检查的调用约定和 PInvoke 签名的参数匹配的目标的非托管的签名。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 08/14/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。