Evento System.AppDomain.UnhandledException

O UnhandledException evento fornece notificação de exceções não detetadas. Ele permite que o aplicativo registre informações sobre a exceção antes que o manipulador padrão do sistema informe a exceção ao usuário e encerre o aplicativo. Se informações suficientes sobre o estado do aplicativo estiverem disponíveis, outras ações podem ser realizadas - como salvar dados do programa para recuperação posterior. Recomenda-se cuidado, porque os dados do programa podem ficar corrompidos quando as exceções não são tratadas. O manipulador também estará funcionando enquanto mantém bloqueios mantidos quando a exceção foi lançada, portanto, deve-se tomar cuidado para evitar esperar por outros recursos que poderiam introduzir bloqueios.

Esse evento pode ser manipulado em qualquer domínio de aplicativo. No entanto, o evento não é necessariamente gerado no domínio do aplicativo onde a exceção ocorreu. Uma exceção não será tratada somente se toda a pilha do thread tiver sido desenrolada sem encontrar um manipulador de exceção aplicável, portanto, o primeiro lugar em que o evento pode ser gerado é no domínio do aplicativo onde o thread se originou.

Se o UnhandledException evento for manipulado no domínio de aplicativo padrão, ele será gerado para qualquer exceção não tratada em qualquer thread, independentemente do domínio do aplicativo em que o thread começou. Se o thread foi iniciado em um domínio de aplicativo que tem um manipulador de eventos para UnhandledException, o evento é gerado nesse domínio de aplicativo. Se esse domínio de aplicativo não for o domínio de aplicativo padrão e também houver um manipulador de eventos no domínio de aplicativo padrão, o evento será gerado em ambos os domínios de aplicativo.

Por exemplo, suponha que um thread começa no domínio do aplicativo "AD1", chama um método no domínio do aplicativo "AD2" e, a partir daí, chama um método no domínio do aplicativo "AD3", onde ele lança uma exceção. O primeiro domínio de aplicação em que o UnhandledException evento pode ser gerado é "AD1". Se esse domínio de aplicativo não for o domínio de aplicativo padrão, o evento também poderá ser gerado no domínio de aplicativo padrão.

Se o manipulador de eventos tiver um ReliabilityContractAttribute atributo com os sinalizadores apropriados, o manipulador de eventos será tratado como uma região de execução restrita.

A partir do .NET Framework 4, esse evento não é gerado para exceções que corrompem o estado do processo, como estouros de pilha ou violações de acesso, a menos que o manipulador de eventos seja crítico para a segurança e tenha o HandleProcessCorruptedStateExceptionsAttribute atributo.

Para registar um manipulador de eventos para este evento, é necessário ter as permissões requeridas, caso contrário, ocorre um erro SecurityException.

Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.

Outros eventos para exceções não tratadas

Para determinados modelos de aplicação, o UnhandledException evento pode ser preemptado por outros eventos se a exceção não tratada ocorrer na thread principal da aplicação.

Em aplicativos que usam Windows Forms, exceções não tratadas no thread principal do aplicativo fazem com que o Application.ThreadException evento seja gerado. Se esse evento for manipulado, o comportamento padrão é que a exceção sem tratamento não encerra o aplicativo, embora o aplicativo seja deixado em um estado desconhecido. Nesse caso, o evento UnhandledException não é levantado. Esse comportamento pode ser alterado usando o arquivo de configuração do aplicativo ou usando o Application.SetUnhandledExceptionMode método para alterar o modo para UnhandledExceptionMode.ThrowException antes que o ThreadException manipulador de eventos seja conectado. Isso se aplica somente ao thread principal do aplicativo. O UnhandledException evento é gerado para exceções não tratadas lançadas em outros threads.

A estrutura do aplicativo Visual Basic fornece outro evento para exceções não tratadas no thread principal do aplicativo — o WindowsFormsApplicationBase.UnhandledException evento. Esse evento tem um objeto de argumentos de evento com o mesmo nome que o objeto de argumentos de evento usado pela AppDomain.UnhandledException, mas com propriedades diferentes. Em particular, esse objeto de argumentos de evento tem uma ExitApplication propriedade que permite que o aplicativo continue em execução, ignorando a exceção não tratada (e deixando o aplicativo em um estado desconhecido). Nesse caso, o evento AppDomain.UnhandledException não é levantado.