WindowsFormsApplicationBase.UnhandledException Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Ocorre quando o aplicativo apresenta uma exceção sem tratamento.
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 Tipo de evento
Exemplos
Este exemplo usa o My.Application.UnhandledException evento para registrar todas as exceções sem tratamento.
Você deve inserir o código na janela Editor de Código para eventos de aplicativo. Para acessar essa janela, siga o procedimento encontrado na seção Comentários deste tópico. Para obter mais informações, consulte Página de aplicativo, Designer de Projeto (Visual Basic).
Como o UnhandledException evento não é gerado quando um depurador é anexado ao aplicativo, você precisa executar este exemplo fora do Ambiente de Desenvolvimento Integrado do 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
Comentários
Um aplicativo aciona o UnhandledException evento quando encontra uma exceção sem tratamento. Esse evento faz parte do modelo de aplicativo do Visual Basic. Para obter mais informações, consulte Visão geral do Modelo de Aplicativo do Visual Basic.
Você pode usar a Exception propriedade do e parâmetro para acessar a exceção sem tratamento que causou esse evento.
Você pode usar a ExitApplication propriedade do e parâmetro para controlar se o aplicativo é encerrado. Por padrão, ExitApplication é True. Portanto, o aplicativo é encerrado depois de concluir o UnhandledException manipulador de eventos. Você pode definir o valor como False no UnhandledException manipulador de eventos para manter o aplicativo em execução e fazer com que ele retorne a um estado de espera.
O código do UnhandledException manipulador de eventos é armazenado no arquivo ApplicationEvents.vb, que está oculto por padrão.
| Para acessar a janela editor de código para eventos de aplicativo |
| 1. Com um projeto selecionado no Gerenciador de Soluções, clique em Propriedades no menu Projeto . 2. Clique na guia Aplicativo. 3. Clique no botão Exibir Eventos do Aplicativo para abrir o Editor de Códigos. |
Para obter mais informações, consulte Página de aplicativo, Designer de Projeto (Visual Basic).
Observação
O compilador do Visual Basic impede que os aplicativos criados para depuração gerem esse evento, para permitir que um depurador manipule as exceções sem tratamento. Isso significa que, se você estiver testando seu aplicativo executando-o no depurador ambiente de desenvolvimento integrado do Visual Studio, seu UnhandledException manipulador de eventos não será chamado. Para obter mais informações sobre como criar aplicativos para depuração, consulte /debug (Visual Basic).
Tarefas
A tabela a seguir lista exemplos de tarefas que envolvem o My.Application.UnhandledException evento.
| Para | Consulte |
|---|---|
| Registrar exceções sem tratamento | Como: registrar exceções em log |
Disponibilidade por tipo de projeto
| Tipo de projeto | Disponível |
|---|---|
| Aplicativo do Windows Forms | Sim |
| Biblioteca de Classes | Não |
| Aplicativo do Console | Não |
| Biblioteca de Controle Windows Forms | Não |
| Biblioteca de Controles da Web | Não |
| Serviço do Windows | Não |
| Site | Não |
