Evento System.AppDomain.UnhandledException
Este artigo fornece observações complementares à documentação de referência para essa API.
O UnhandledException evento fornece notificação de exceções não capturadas. Ele permite que o aplicativo registre informações sobre a exceção antes que o manipulador padrão do sistema relate 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 executadas - como salvar dados do programa para recuperação posterior. Recomenda-se cuidado, pois os dados do programa podem ser corrompidos quando as exceções não são tratadas. O manipulador também estará em execução enquanto mantém os bloqueios mantidos quando a exceção foi lançada, portanto, deve-se tomar cuidado para evitar esperar por outros recursos que possam introduzir deadlocks.
Esse evento pode ser manipulado em qualquer domínio de aplicativo. No entanto, o evento não é necessariamente gerado no domínio do aplicativo em que a exceção ocorreu. Uma exceção será destratada somente se toda a pilha do thread tiver sido desenrolada sem encontrar um manipulador de exceção aplicável, portanto, o primeiro local em que o evento pode ser gerado é no domínio do aplicativo em que o thread se originou.
Se o UnhandledException evento for manipulado no domínio de aplicativo padrão, ele será gerado para qualquer exceção sem tratamento em qualquer thread, independentemente do domínio de aplicativo em que o thread foi iniciado. Se o thread for iniciado em um domínio de aplicativo que tenha um manipulador de eventos para UnhandledException, o evento será 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 comece no domínio de aplicativo "AD1", chame um método no domínio de aplicativo "AD2" e, a partir daí, chame um método no domínio de aplicativo "AD3", onde ele lança uma exceção. O primeiro domínio de aplicativo no qual 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.
Observação
O Common Language Runtime suspende as anulações de thread enquanto os manipuladores de eventos do UnhandledException evento estão em execuçã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 registrar um manipulador de eventos para esse evento, você deve ter as permissões necessárias, ou um SecurityException é lançado.
Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.
Outros eventos para exceções sem tratamento
Para determinados modelos de aplicativo, o UnhandledException evento pode ser preemptado por outros eventos se a exceção sem tratamento ocorrer no thread principal do aplicativo.
Em aplicativos que usam Windows Forms, exceções sem tratamento no thread do aplicativo principal fazem com que o Application.ThreadException evento seja gerado. Se esse evento for manipulado, o comportamento padrão será que a exceção sem tratamento não encerrará o aplicativo, embora o aplicativo seja deixado em um estado desconhecido. Nesse caso, o UnhandledException evento não é gerado. 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 manipulador de ThreadException eventos seja conectado. Isso se aplica apenas ao thread principal do aplicativo. O UnhandledException evento é gerado para exceções sem tratamento lançadas em outros threads.
A estrutura do aplicativo Visual Basic fornece outro evento para exceções sem tratamento 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 pelo 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 sem tratamento (e deixando o aplicativo em um estado desconhecido). Nesse caso, o AppDomain.UnhandledException evento não é gerado.
