WindowsFormsApplicationBase.UnhandledException Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando a aplicação encontra uma exceção não tratada.
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 registar quaisquer exceções não tratadas.
Deve introduzir o código na janela do Editor de Código para os eventos da aplicação. Para aceder a esta janela, siga o procedimento encontrado na secção de Observações deste tópico. Para obter mais informações, consulte Página de aplicativo, Project Designer (Visual Basic).
Como o evento UnhandledException não é ativado quando um depurador está ligado à aplicação, tem de executar este exemplo fora do Ambiente de Desenvolvimento Integrado 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
Observações
Uma aplicação levanta o UnhandledException evento quando encontra uma exceção não tratada. Este evento faz parte do modelo de aplicação Visual Basic. Para mais informações, consulte Visão Geral do Modelo de Aplicação Visual Basic.
Pode usar a Exception propriedade do e parâmetro para aceder à exceção não tratada que causou este evento.
Podes usar a ExitApplication propriedade do e parâmetro para controlar se a aplicação encerra. Por padrão, ExitApplication é True. Portanto, a aplicação sai após completar o UnhandledException gestor de eventos. Podes definir o valor no FalseUnhandledException gestor de eventos para manter a aplicação a funcionar, e fazê-la voltar para um estado de espera.
O código do UnhandledException gestor de eventos é armazenado no ficheiro ApplicationEvents.vb, que está oculto por defeito.
Para aceder à janela do Editor de Código para eventos de aplicação: |1. Com uma project selecionada em Explorador de Soluções, clique em Properties no menu Project.
2. Clique na guia Aplicativo .
3. Clique no botão Ver Eventos da Aplicação para abrir o Editor de Código.|
Para obter mais informações, consulte Página de aplicativo, Project Designer (Visual Basic).
Note
O compilador Visual Basic impede que aplicações construídas para depuração gerem este evento, permitindo que um depurador trate das exceções não tratadas. Isto significa que, se estiver a testar a sua aplicação executando-a no depurador Visual Studio Integrated Development Environment, o seu gestor de eventos UnhandledException não será chamado. Para mais informações sobre a construção de aplicações para depuração, veja /debug (Visual Basic).
Tasks
A tabela seguinte lista exemplos de tarefas que envolvem o My.Application.UnhandledException evento.
| Para | Veja |
|---|---|
| Registo exceções não tratadas | Como registar exceções |
Disponibilidade por tipo de projeto
| Tipo de Projeto | Available |
|---|---|
| Aplicação Windows Forms | Sim |
| Biblioteca de Classes | No |
| Aplicativo de console | No |
| Biblioteca de Controlo Windows Forms | No |
| Biblioteca de controle da Web | No |
| Serviço Windows | No |
| Web site | No |