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).

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.

Свойство параметра можно использовать Exceptione для доступа к необработанным исключениям, вызвавших это событие.

Для управления выходом e приложения можно использовать ExitApplication свойство параметра . По умолчанию ExitApplication имеет значение True. Таким образом, приложение завершает работу после завершения обработчика UnhandledException событий. В обработчике событий можно задать значение , FalseUnhandledException чтобы приложение работало и возвращалось в состояние ожидания.

Код обработчика UnhandledException событий хранится в файле ApplicationEvents.vb, который по умолчанию скрыт.
Доступ к окну Редактор кода для событий приложения
1. Выбрав проект в Обозреватель решений, щелкните Свойства в меню Проект.
2. Перейдите на вкладку Приложение .
3. Нажмите кнопку Просмотреть события приложения, чтобы открыть Редактор кода.

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

Примечание

Компилятор Visual Basic запрещает приложениям, созданным для отладки, вызывать это событие, чтобы позволить отладчику обрабатывать необработанных исключений. Это означает, что при тестировании приложения путем его запуска в отладчике UnhandledException интегрированной среды разработки Visual Studio обработчик событий вызываться не будет. Дополнительные сведения о создании приложений для отладки см. в разделе /debug (Visual Basic).

Задания

В следующей таблице перечислены примеры задач, связанных с событием My.Application.UnhandledException .

Кому См.
Ведение журнала необработанных исключений Практическое руководство. Исплючения журналов

Доступность по типу проекта

Тип проекта Доступно
Приложение Windows Forms Да
Библиотека классов Нет
Консольное приложение Нет
Библиотека элементов управления Windows Forms Нет
Библиотека веб-элементов управления Нет
Службы Windows Нет
Веб-сайт Нет

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

См. также раздел