Share via

.NET 本机应用中的运行时异常

  • 项目

请务必在通用 Windows 平台应用程序的目标平台上测试它们的发布版本，因为调试和发布配置完全不同。 默认情况下，调试配置使用 .NET Core 运行时来编译应用程序，但发布配置使用 .NET 本机将应用程序编译为本机代码。

重要

有关处理在测试应用的发布版本时可能遇到的 MissingMetadataException、MissingInteropDataException 和 MissingRuntimeArtifactException 异常的信息，请参阅“步骤 4：手动解决缺少的元数据：在入门主题以及反射和 .NET Native 和运行时指令 (rd.xml) 配置文件参考中。

调试和发布版本

当调试版本针对 .NET Core 运行时执行时，它未编译为本机代码。 这使得你的应用可使用通常由运行时提供的所有服务。

另一方面，发布版本编译为其目标平台的本机代码，删除外部运行时和库的大多数依赖项，并很大程度优化代码以获得最佳性能。

对使用 .NET 本机编译的发布版本进行调试时：

  • 请使用不同于普通的 .NET 调试工具的 .NET 本机调试引擎。

  • 尽可能减小了可执行文件的大小。 .NET 本机减小可执行文件的大小的方法之一是大量清理运行时异常消息， Runtime exception messages 部分中更详细地讨论了这一主题。

  • 很大程度优化了你的代码。 这意味着只要有可能就会使用该内联。 (内联将代码从外部例程移动到调用例程。) .NET Native提供专用运行时并实现主动内联这一事实会影响调试时显示的调用堆栈。 有关详细信息，请参阅 Runtime call stack 部分。

注意

通过选中或取消选中“使用 .NET 本机工具链进行编译” 框，可以控制是否使用 .NET 本机工具链编译调试和发布版本。 但是，Microsoft Store 将始终使用 .NET Native 工具链编译应用的生产版本。

Runtime exception messages

为尽量减少应用程序可执行文件的大小，.NET 本机不包含异常消息的完整文本。 因此，在发布版本中引发的运行时异常可能不显示异常消息的完整文本。 相反，该文本可能由一个子字符串和一个链接构成，跟随该链接可获取详细信息。 例如，异常信息可能显示为：

Exception thrown: '$16_System.AggregateException' in Unknown Module.

Additional information: AggregateException_ctor_DefaultMessage

If there is a handler for this exception, the program may be safely continued.

如果需要完整的异常消息，请改为运行调试版本。 例如，发布版本中的上一个异常信息在调试版本中可能显示如下：

Exception thrown: 'System.AggregateException' in NativeApp.exe.

Additional information: Value does not fall within the expected range.

Runtime call stack

由于内联和其他优化，由 .NET Native 工具链编译的应用显示的调用堆栈可能无益于清晰地标识运行时异常的路径。

若要获取完整的堆栈，请改为运行调试版本。

另请参阅