Application.UnhandledException 事件

定义

当异常可由应用代码处理时发生,从本机级别Windows 运行时错误转发。 应用可以将事件标记为在事件数据中已处理。

public:
 virtual event UnhandledExceptionEventHandler ^ UnhandledException;
// Register
event_token UnhandledException(UnhandledExceptionEventHandler const& handler) const;

// Revoke with event_token
void UnhandledException(event_token const* cookie) const;

// Revoke with event_revoker
Application::UnhandledException_revoker UnhandledException(auto_revoke_t, UnhandledExceptionEventHandler const& handler) const;
public event UnhandledExceptionEventHandler UnhandledException;
function onUnhandledException(eventArgs) { /* Your code */ }
application.addEventListener("unhandledexception", onUnhandledException);
application.removeEventListener("unhandledexception", onUnhandledException);
- or -
application.onunhandledexception = onUnhandledException;
Public Custom Event UnhandledException As UnhandledExceptionEventHandler 

事件类型

注解

事件UnhandledException用于通知应用 XAML 框架或通常Windows 运行时未由应用代码处理的异常。

例如,如果Windows 运行时像事件处理程序一样调用应用代码,并且应用代码引发异常且未捕获它,则异常将传播回Windows 运行时。 然后,Windows 运行时将触发 UnhandledException 事件,以通知应用此异常。

处理 中的 UnhandledException 异常只是可用于调试和运行时异常处理和可能的恢复的众多技术之一。 有关可用于调试和错误处理的整套技术的详细信息,请参阅 异常处理 (C# 编程指南)

请注意,仅当应用代码不再可能捕获异常时,才会触发此事件。 例如,假设应用事件处理程序调用Windows 运行时 API,而该 API 又调用回调。 如果内部应用代码引发异常但未捕获它,则异常将通过Windows 运行时传播回应用代码的外部层,该层将有机会捕获它。 UnhandledException仅当应用代码不再有机会通过正常传播捕获异常时,才会触发 事件。

也可能引发异常,并且永远不会有任何机会被应用代码捕获。 例如,如果 XAML 框架正在执行布局并引发异常,则此异常不会通过任何应用代码传播。 在这种情况下,将 UnhandledException 触发 事件,这是首次向任何应用代码发出异常通知。

通常,在UnhandledException触发事件后,Windows 运行时会终止应用,因为异常未处理。 应用代码对此有一些控制:如果事件处理程序将 UnhandledException 事件参数的 Handled 属性设置为 true,则在大多数情况下,应用不会终止。 但是,出于以下几个原因,不建议定期这样做:

  • 通常, UnhandledException 事件处理程序没有足够的信息来知道在异常后继续操作是否安全。 部分应用程序代码或Windows 运行时可能处于不一致状态,如果应用继续运行其代码,可能会导致后续失败。
  • Windows 运行时将在某些操作期间遇到的异常视为不可恢复,因为Windows 运行时本身在这些异常之后将处于不一致状态。 对于此类异常,即使事件处理程序将 UnhandledExceptionHandled 设置为 true,应用仍将终止。
  • 导航期间发生的错误可能会导致一种状态,其中没有内容加载,也没有向用户指示应用仍在运行。
  • 有关这些点的详细信息,请参阅 异常处理 (C# 编程指南)

一个值得注意的限制是, UnhandledException 事件参数包含的详细信息不如从应用代码传播的原始异常多。 如果应用需要特定异常的特定处理,只要可能,最好在异常传播时捕获该异常,因为届时将提供更多详细信息。 事件 UnhandledException 参数通过 Exception 属性公开 异常 对象。 但是,不保证此异常对象的类型、消息和堆栈跟踪与引发的原始异常相匹配。 事件参数会公开 Message 属性。 在大多数情况下,这将包含最初引发的异常的消息。

在 App.xaml) 的 Application 元素上,无法在 XAML (中为 连接 处理程序UnhandledException。 必须在代码中的 Application 对象上附加 处理程序UnhandledException,无论是在构造函数中还是在激活逻辑中。

适用于

另请参阅