WindowsFormsApplicationBase.UnhandledException WindowsFormsApplicationBase.UnhandledException WindowsFormsApplicationBase.UnhandledException WindowsFormsApplicationBase.UnhandledException Event

Определение

Возникает, если приложение обнаруживает необработанное исключение.Occurs when the application encounters an unhandled exception.

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 событие для записи в журнал любых необработанных исключений.This example uses the My.Application.UnhandledException event to log any unhandled exceptions.

Необходимо ввести код в окне редактора кода для событий приложения.You must enter the code in the Code Editor window for application events. Чтобы открыть это окно, выполните процедуру, описанную в разделе «Примечания» этого раздела.To access this window, follow the procedure found in this topic's Remarks section. Дополнительные сведения см. в разделе Application Page, Project Designer (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

UnhandledException Поскольку событие не возникает при присоединении отладчика к приложению, необходимо выполнить этот пример вне интегрированной среды разработки Visual Studio.Because the UnhandledException event is not raised when a debugger is attached to the application, you have to run this example outside the Visual Studio Integrated Development Environment.

Private Sub MyApplication_UnhandledException( 
    ByVal sender As Object, 
    ByVal e As Microsoft.VisualBasic.ApplicationServices.UnhandledExceptionEventArgs 
) Handles Me.UnhandledException

    My.Application.Log.WriteException(e.Exception, 
        TraceEventType.Critical, 
        "Unhandled Exception.")
End Sub

Комментарии

Приложение вызывает UnhandledException событие при обнаружении необработанного исключения.An application raises the UnhandledException event when it encounters an unhandled exception. Это событие является частью модели приложения Visual Basic.This event is part of the Visual Basic Application model. Дополнительные сведения см. в разделе Общие сведения о модели приложения Visual Basic.For more information, see Overview of the Visual Basic Application Model.

Exception Свойствоe параметра можно использовать для доступа к необработанному исключению, которое привело к возникновению этого события.You can use the Exception property of the e parameter to access the unhandled exception that caused this event.

ExitApplication Свойствоe параметра можно использовать для управления выходом из приложения.You can use the ExitApplication property of the e parameter to control whether the application exits. По умолчанию ExitApplication имеет Trueзначение.By default, ExitApplication is True. Поэтому приложение завершает работу после завершения UnhandledException обработчика событий.Therefore, the application exits after completing the UnhandledException event handler. Можно задать значение False UnhandledException в обработчике событий, чтобы приложение заработало и возвращалось в состояние ожидания.You can set the value to False in the UnhandledException event handler to keep the application running, and have it return to a waiting state.

Код для UnhandledException обработчика событий хранится в файле ApplicationEvents. vb, который по умолчанию скрыт.The code for the UnhandledException event handler is stored in the ApplicationEvents.vb file, which is hidden by default.

Доступ к окну редактора кода для событий приложенияTo access the Code Editor window for application events
1. Выбрав проект в Обозреватель решений, в меню проект выберите пункт свойства .1. With a project selected in Solution Explorer, click Properties on the Project menu.
2. Перейдите на вкладку Приложение .2. Click the Application tab.
3. Нажмите кнопку Просмотреть события приложения , чтобы открыть редактор кода.3. Click the View Application Events button to open the Code Editor.

Дополнительные сведения см. в разделе Application Page, Project Designer (Visual Basic).For more information, see Application Page, Project Designer (Visual Basic).

Примечание

Компилятор Visual Basic не позволяет приложениям, созданным для отладки, от вызова этого события, включать отладчик для обработки необработанных исключений.The Visual Basic compiler prevents applications that are built for debugging from raising this event, to enable a debugger to handle the unhandled exceptions. Это означает, что если вы тестируете приложение, запустив его в отладчике интегрированной среды разработки Visual Studio, UnhandledException обработчик событий не будет вызываться.This means that if you are testing your application by running it under the Visual Studio Integrated Development Environment debugger, your UnhandledException event handler will not be called. Дополнительные сведения о создании приложений для отладки см. в разделе /Debug (Visual Basic).For more information about building applications for debugging, see /debug (Visual Basic).

ЗадачиTasks

В следующей таблице приведены примеры задач, в которых участвует My.Application.UnhandledException данное событие.The following table lists examples of tasks that involve the My.Application.UnhandledException event.

КомуTo См.See
Регистрация необработанных исключенийLog unhandled exceptions Практическое руководство. Запись в журнал сведений об исключенияхHow to: Log Exceptions

Доступность по типу проектаAvailability by Project Type

Тип проектаProject type ДоступноAvailable
Приложение Windows FormsWindows Forms Application ДаYes
Библиотека классовClass Library НетNo
Консольное приложениеConsole Application НетNo
Библиотека элементов управления Windows FormsWindows Forms Control Library НетNo
Библиотека веб-элементов управленияWeb Control Library НетNo
Служба WindowsWindows Service НетNo
Веб-сайтWeb Site НетNo

Безопасность

SecurityPermission
Управляет возможностью добавления обработчика событий для этого события.Controls the ability to add an event handler for this event. Связанное перечисление: ControlAppDomain.Associated enumeration: ControlAppDomain.

Применяется к

Дополнительно