WindowsFormsApplicationBase.UnhandledException Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возникает, когда приложение обнаруживает необработанное исключение.
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 для регистрации необработанных исключений.
Необходимо ввести код в окне редактора кода для событий приложения. Чтобы получить доступ к этому окну, выполните процедуру, приведенную в разделе "Примечания". Дополнительные сведения см. в разделе "Страница приложения", конструктор проектов (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 для доступа к необработанным исключениям, вызвавшего это событие.
Свойство параметра можно использовать ExitApplicatione для управления выходом приложения. По умолчанию ExitApplication — это True. Поэтому приложение завершает работу после завершения обработчика UnhandledException событий. Можно задать значение False в обработчике UnhandledException событий, чтобы сохранить работу приложения и вернуться в состояние ожидания.
Код обработчика UnhandledException событий хранится в файле ApplicationEvents.vb, который по умолчанию скрыт.
Чтобы получить доступ к окну редактора кода для событий приложения: |1. Выбрав проект в обозревателе решений, щелкните "Свойства " в меню "Проект ".
2. Щелкните вкладку "Приложение ".
3. Нажмите кнопку "Просмотреть события приложения" , чтобы открыть редактор кода.|
Дополнительные сведения см. в разделе "Страница приложения", конструктор проектов (Visual Basic).
Замечание
Компилятор Visual Basic запрещает приложениям, созданным для отладки этого события, чтобы отладчик мог обрабатывать необработанные исключения. Это означает, что если вы тестируете приложение, выполняя его в отладчике интегрированной среды разработки Visual Studio, обработчик UnhandledException событий не будет вызываться. Дополнительные сведения о создании приложений для отладки см. в разделе /debug (Visual Basic).
Задачи
В следующей таблице перечислены примеры задач, связанных с событием My.Application.UnhandledException .
| Кому | Смотри |
|---|---|
| Журнал необработанных исключений | Практическое руководство: Регистрация исключений |
Доступность по типу проекта
| тип проекта | В наличии |
|---|---|
| Приложение Windows Forms | Да |
| Библиотека классов | Нет |
| Консольное приложение | Нет |
| Библиотека элементов управления Windows Forms | Нет |
| Библиотека веб-элементов управления | Нет |
| Службы Windows | Нет |
| Веб-сайт | Нет |
