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 detectadas. 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 realizadas - como salvar dados do programa para recuperação posterior. Recomenda-se cuidado, pois os dados do programa podem ficar corrompidos quando exceções não são manipuladas.

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 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 de aplicativo em que o UnhandledException thread foi iniciado. Se o thread foi 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 do aplicativo "AD1", chame um método no domínio do aplicativo "AD2" e, a partir daí, chame um método no domínio do 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 sendo executados.

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 de 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 não tratadas

Para determinados modelos de aplicativo, o UnhandledException evento pode ser antecipado por outros eventos se a exceção não tratada ocorrer no thread do aplicativo principal.

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

A estrutura de aplicativo do Visual Basic fornece outro evento para exceções não tratadas no thread de aplicativo principal — 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 não tratada (e deixando o aplicativo em um estado desconhecido). Nesse caso, o AppDomain.UnhandledException evento não é levantado.