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 encontra 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 em log quaisquer 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 do 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 gera 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 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ódigo.|
Para obter mais informações, consulte Página do Aplicativo, Designer de Projeto (Visual Basic).
Observação
O compilador do Visual Basic impede que os aplicativos criados para depuração criem 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 do 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 /depuração (Visual Basic).
Tasks
A tabela a seguir lista exemplos de tarefas que envolvem o My.Application.UnhandledException evento.
| Para | Veja |
|---|---|
| Registrar exceções sem tratamento | Como registrar exceções |
Disponibilidade por tipo de projeto
| Tipo de projeto | Disponível |
|---|---|
| Aplicativo do Windows Forms | Sim |
| Biblioteca de Classes | No |
| Aplicativo de console | No |
| Biblioteca de controle do Windows Forms | No |
| Biblioteca de Controle da Web | No |
| Serviço do Windows | No |
| Site | No |
