WindowsFormsApplicationBase.UnhandledException 事件
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
在应用程序遇到未经处理的异常时发生。
public:
event Microsoft::VisualBasic::ApplicationServices::UnhandledExceptionEventHandler ^ UnhandledException;
public event Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventHandler UnhandledException;
member this.UnhandledException : Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventHandler
Public Custom Event UnhandledException As UnhandledExceptionEventHandler
事件类型
示例
此示例使用 My.Application.UnhandledException
事件记录任何未经处理的异常。
必须在应用程序事件的“代码编辑器”窗口中输入代码。 若要访问此窗口,请按照本主题的“备注”部分中的过程进行操作。 有关详细信息,请参阅 Application Page, Project Designer (Visual Basic)(应用程序页、项目设计器 (Visual Basic)。
由于调试 UnhandledException
器附加到应用程序时不会引发 事件,因此必须在 Visual Studio 集成开发环境外部运行此示例。
Private Sub MyApplication_UnhandledException(
sender As Object,
e As Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventArgs
) Handles Me.UnhandledException
My.Application.Log.WriteException(e.Exception,
TraceEventType.Critical,
"Unhandled Exception.")
End Sub
注解
应用程序在 UnhandledException
遇到未经处理的异常时引发 事件。 此事件是 Visual Basic 应用程序模型的一部分。 有关详细信息,请参阅 Visual Basic 应用程序模型概述。
可以使用 Exception 参数的 e
属性访问导致此事件的未经处理的异常。
可以使用 ExitApplication 参数的 e
属性来控制应用程序是否退出。 默认情况下,ExitApplication 为 True
。 因此,应用程序在完成 UnhandledException
事件处理程序后退出。 可以在事件处理程序中UnhandledException
将值设置为 False
,使应用程序保持运行,并使其返回到等待状态。
事件处理程序的代码 UnhandledException
存储在默认隐藏的 ApplicationEvents.vb 文件中。
访问应用程序事件的“代码编辑器”窗口 |
1. 在解决方案资源管理器中选择项目后,单击“项目”菜单上的“属性”。 2. 单击“应用程序”选项卡。 3. 单击“ 查看应用程序事件 ”按钮以打开代码编辑器。 |
有关详细信息,请参阅 Application Page, Project Designer (Visual Basic)(应用程序页、项目设计器 (Visual Basic)。
注意
Visual Basic 编译器阻止为调试生成的应用程序引发此事件,使调试器能够处理未经处理的异常。 这意味着,如果在 Visual Studio 集成开发环境调试器下运行应用程序来测试应用程序, UnhandledException
则不会调用事件处理程序。 有关生成用于调试的应用程序的详细信息,请参阅 /debug (Visual Basic) 。
任务
下表列出了涉及 My.Application.UnhandledException
事件的任务示例。
功能 | 查看 |
---|---|
记录未经处理的异常 | 如何:日志异常 |
可用性(按项目类型)
项目类型 | 可用 |
---|---|
Windows 窗体应用程序 | 是 |
类库 | 否 |
控制台应用程序 | 否 |
Windows 窗体控件库 | 否 |
Web 控件库 | 否 |
Windows 服务 | 否 |
网站 | 否 |