Compartilhar via


WindowsFormsApplicationBase.UnhandledException Evento

Definição

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

Aplica-se a

Confira também