WindowsFormsApplicationBase.UnhandledException 事件

  • 参考

定义

命名空间:
Microsoft.VisualBasic.ApplicationServices
程序集:
Microsoft.VisualBasic.dll
程序集:
Microsoft.VisualBasic.Forms.dll

在应用程序遇到未经处理的异常时发生。

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

事件类型

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 服务 否
网站 否

适用于

另请参阅