Usamos cookies para medir audiência e melhorar sua experiência. Você pode aceitar ou recusar a qualquer momento. Veja sobre o iMasters.
O tratamento de erros é fundamental em qualquer aplicação e neste artigo veremos como tratar e registrar os erros em um local comum, independente de onde eles ocorram, em uma aplicação ASP .NET.
Para efetuar o tratamento a nível de aplicação, você deve usar o evento Application_Error no arquivo Global.asax; este evento ocorre para qualquer exceção não tratada na aplicação.
Podemos realizar esta tarefa cumprindo as seguintes etapas:
- Criar um tratamento para o evento Page_Error;
- Relançar as páginas de erros a partir dos métodos;
- Criar um tratamento para o evento Application_Error;
- Criar uma mensagem detalhada e escrevê-la no log de eventos;Resumindo: você vai ter que incorporar o tratamento de erros nos métodos; adicionar código ao manipulador de eventos Page_Error para relançar os erros de página; adicionar o código para o manipulador de eventos Application_Error no arquivo Global.asax e finalmente criar uma mensagem detalhada e executar o seu registro, fazendo o redirecionamento usando Server.Transfer.
O modelo de tratamento de exceções na plataforma ASP.NET fornece a capacidade para tratar as exceções em qualquer nível, desde o nível de método até o nível de aplicação.
Uma exceção não tratada é sequencialmente relançada para cada método na pilha de chamadas. Se nenhum método na pilha de chamadas tratar a exceção, o evento Page_Error será gerado.
Se a exceção não é tratada no evento Page_Error, o evento será relançado e o evento Application_Error é disparado. O relançamento de exceções ao nível de aplicação permite o processamento em um único local da a aplicação.
Para processar erros no nível de aplicação, cada página deve incluir o manipulador de eventos Page_Error com uma única linha de código para relançar a última exceção que ocorreu. Exemplo:
Private Sub Page_Error(ByVal sender As Object,ByVal e As System.EventArgs) Handles MyBase.Error
'relanca o ulimo erro ocorrido
Throw Server.GetLastError( )
End Sub
VB .NET
private void Page_Error(Object sender,System.EventArgs e)
{
**** //relança o último erro ocorrido
**** throw Server.GetLastError( );
****}
********
**** C#
Fazemos essa etapa para evitar as informações das exceções envolvidas com uma exceção HttpUnhandledException. A ASP.NET cria automaticamente uma nova HttpUnhandledException no nível da página, a menos que você relance a última exceção, que a partir da perspectiva da ASP.NET constitui uma manipulação de exceção.
Esta é uma das formas de tratar este problema e você não é obrigado a seguir este caminho.
O tratamento de erro para a aplicação é colocado no manipulador de eventos Application_Error (no arquivo global.asax).O primeiro passo é obter uma referência para a última exceção que ocorreu. Exemplo:
UltimaException = Server.GetLastError() VB.NET
UltimaException = Server.GetLastError(); C#
O próximo passo é a criação de uma mensagem detalhada para inserir no registro de eventos. Esta mensagem deve conter a mensagem da exceção mais recente e uma relação completa de todas as informações de erro na lista de links de exceções. A relação completa é obtida chamando o método ToString da última exceção, como no seguinte exemplo de código:
msg = UltimaException.Message & vbCrLf & vbCrLf & UltimaException.ToString() VB.NET
msg = UltimaException.Message + "\r\r" + UltimaException.ToString(); C#
Em seguida, você pode escrever a mensagem no log de eventos e isto é feito através da criação de um novo objeto EventLog, definindo a propriedade de origem para uma constante contendo o nome da fonte de evento para gravar as informações (log do Aplicativo no nosso exemplo), e escrever a mensagem no log de eventos.
Ao escrever a entrada no log de eventos, o tipo de evento pode ser definido como Error, FailureAudit, information, SuccessAudit e Warning, todos os quais são membros da enumeração EventLogEntryType. A seguir temos o código que escreve o log de eventos no nosso exemplo:
Log = New EventLog
Log.Source = EVENT_LOG_NAME
Log.WriteEntry(msg,EventLogEntryType.Error)
VB.NET
log = new EventLog();
log.Source = EVENT_LOG_NAME;
log.WriteEntry(msg,EventLogEntryType.Error);
C#
O passo final para o processamento dos erros a nível de aplicativo é limpar o erro e redirecionar o usuário para a página onde uma mensagem de erro será exibida segundo este código:
Server.ClearError( )"&Mensagem1=" & UltimaException.Message & _
"&Mensagem2=" & _
"Este erro foi processado a nível de Aplicação")
VB.NET
Server.ClearError( );
Server.Transfer("ExibeErroCS.aspx" +
"?PageHeader=Erro Ocorrido" +
"&Mensagem1=" + UltimaException.Message +
"&Mensagem2=" +
"Este erro foi processado a nível de Aplicação");
C#
Se você não limpar o erro, o ASP.NET irá assumir que erro não foi processado e vai lidar com isso para você com sua infame "tela amarela" de erros.
Você pode usar um dos dois métodos abaixo para redirecionar o usuário para a página de erro:Você não pode criar uma nova fonte de eventos dentro de sua aplicação ASP.NET usando o editor de registro e adicionando uma nova chave para a pasta: \System\CurrentControlSet\ HKEY_LOCAL_MACHINE Services\EventLog ou criando um aplicativo console para fazer o trabalho para você (esta última opção é mais fácil).
Usando a segunda opção crie um aplicativo console, adicione o código a seguir a ele, e execute o aplicativo. Isto irá criar uma fonte de eventos específico para sua aplicação. A única alteração necessária para o código descrito aqui é para alterar o valor da constante EVENT_LOG_NAME para o nome de sua nova fonte de eventos.
Const EVENT_LOG_NAME As String = "Sua Aplicação"
if (Not EventLog.SourceExists(EVENT_LOG_NAME)) Then
EventLog.CreateEventSource(EVENT_LOG_NAME, EVENT_LOG_NAME)
End If
VB.NET
const String EVENT_LOG_NAME = "Sua aplicação";
if (EventLog.SourceExists(EVENT_LOG_NAME) != null)
{
EventLog.CreateEventSource(EVENT_LOG_NAME, EVENT_LOG_NAME);
}
C#
O código completo para do evento Application_Error no arquivo Global.asax é dado a seguir:Sub Application_Error(ByVal sender As Object, ByVal e As EventArgs)
Const EVENT_LOG_NAME As String = "Sua Aplicação"
Dim lastException As Exception
Dim Log As EventLog
Dim msg As String
'pega o ultimo erro ocorrido
UltimaException = Server.GetLastError()
'cria a mensagem de erro a partir da mensagem na ultima exceção
'com uma relação completa de exceções internas
msg = UltimaException.Message & _
vbCrLf & vbCrLf & _
UltimaException.ToString()
'Insere a informação do erro no log de eventos
Log = New EventLog
Log.Source = EVENT_LOG_NAME
Log.WriteEntry(msg, EventLogEntryType.Error)
'limpa o erro e redireciona a pagina usada para exibir a informação de erro
Server.ClearError()
Server.Transfer("ExibeErroVB.aspx" & _
"?PageHeader=Erro Ocorrido" & _
"&Mensagem1=" & UltimaException.Message & _
"&Mensagem2=" &_
"Este erro foi processado a nível de Aplicação")
End Sub
Na entrada do log de eventos podemos ver o seguinte padrão de mensagens:
System.NullReferenceException: {"Object reference not set to an instance
of an object."}
Data: {System.Collections.ListDictionaryInternal}
HelpLink: Nothing
HResult: -2147467261
InnerException: Nothing
IsTransient: False
Message: "Object reference not set to an instance of an object."
Source: "App_Web_23987dfhdty"
StackTrace: " at Macoratti.VBExemplo.
CH08ApplicationLevelErrorHandlingVB.Page_Error(Object sender, EventArgs e)
in E:\Macoratti\projects\MacorattiASPNET\
ApplicationLevelErrorHandlingVB.aspx.vb:line 41
at System.Web.UI.TemplateControl.OnError(EventArgs e)
at System.Web.UI.Page.HandleError(Exception e)
at System.Web.UI.Page.ProcessRequestMain(Boolean includeStagesBeforeAsyncPoint,
Boolean includeStagesAfterAsyncPoint)
at System.Web.UI.Page.ProcessRequest(Boolean includeStagesBeforeAsyncPoint,
Boolean includeStagesAfterAsyncPoint)
at System.Web.UI.Page.ProcessRequest( )
at System.Web.UI.Page.ProcessRequest(HttpContext context)
at System.Web.HttpApplication.CallHandlerExecutionStep.System.Web.
HttpApplication.IExecutionStep.Execute( )
at System.Web.HttpApplication.ExecuteStep(IExecutionStep step, Boolean&
completedSynchronously)"
TargetSite: {System.Reflection.RuntimeMethodInfo}
http://imasters.com.br/artigo/25076/dotnet/asp-net-tratamento-de-erro-a-nivel-da-aplicacao
Carregando comentários...