ASP.NET Code
  Home arrow ASP.NET Code arrow Global error handling with e-mail notifica...
ASP Free Forums 
.NET  
ASP  
ASP Code  
ASP.NET  
ASP.NET Code  
BrainDump  
C#  
Code Examples  
Database  
Database Code  
IIS  
Microsoft Access  
MS SQL Server  
Silverlight  
Visual Basic.NET  
Windows Scripting  
Windows Security  
XML  
Mobile Linux 
App Generation ROI 
IBM® developerWorks 
ASP Web Hosting  
ASP.NET Web Hosting 
Windows Web Hosting
 
Weekly Newsletter
 
Developer Updates  
Free Website Content 
 RSS  Articles
 RSS  Forums
 RSS  All Feeds
Write For Us Get Paid 
Request Media Kit
Contact Us 
Site Map 
Privacy Policy 
Support 
 USERNAME
 
 PASSWORD
 
 
  >>> SIGN UP!  
  Lost Password? 
ASP.NET CODE

Global error handling with e-mail notification
By: Tyler Peelen
  • Search For More Articles!
  • Disclaimer
  • Author Terms
  • Rating: 5 stars5 stars5 stars5 stars5 stars / 1
    2002-08-21

    Table of Contents:

    Rate this Article: Poor Best 
      ADD THIS ARTICLE TO:
      Del.ici.ous Digg
      Blink Simpy
      Google Spurl
      Y! MyWeb Furl
    Email Me Similar Content When Posted
    Add Developer Shed Article Feed To Your Site
    Email Article To Friend
    Print Version Of Article
    PDF Version Of Article
     
     
    ADVERTISEMENT


    In this article I am going to share some techniques on globally trapping and handling errors that occur in a web application and then how to notify administrators/developers that the error has occurred. I will use the Application_OnError subroutine of the global.asax file to trap the errors and then the aspNetEmail component to send the error notification e-mails.[bold]Introduction[/bold]When porting our campus? student information portal to ASP.NET, we realized that the previous ASP ...In this article I am going to share some techniques on globally trapping and handling errors that occur in a web application and then how to notify administrators/developers that the error has occurred. I will use the Application_OnError subroutine of the global.asax file to trap the errors and then the aspNetEmail component to send the error notification e-mails.[bold]Introduction[/bold]When porting our campus? student information portal to ASP.NET, we realized that the previous ASP version generated many errors that we had no idea had occurred. It was decided that in the new version we needed some way to trap errors and then e-mail us information about the error.We didn?t want to use System.Web.Mail because our administrators did not want to install SMTP server on all of our web servers. After looking around a bit, we decided to go with the aspNetEmail component, which in addition to allowing us to use our single campus SMTP server, also allowed for us to dynamically create the HTML error e-mails and include DataGrids.[bold]Error Trapping[/bold]Error trapping and handling at an application level is super easy to do in ASP.NET. All errors occur at the application level, so you can trap errors using the Application_OnError method of global.asax.In our Application_OnError subroutine, we grab the exception for the error using Context.Error.GetBaseException() as seen in the code below:


    Sub Application_Error(ByVal sender As ObjectByVal e As EventArgs)
    Dim ex As Exception Context.Error.GetBaseException()

    Dim objErrHandler As New ErrorHandler()
    objErrHandler.SendHtmlErrorEmail(ex)
    End Sub

    After the exception is grabbed, it is passed to the SendHtmlErrorEmail function of the ErrorHandler class, which does the work of generating the e-mail.[bold]Collecting additional information[/bold]In addition to being sent information about the error itself, we also needed to be sent information about the session that generated the error, like QueryString & Form variables, Server Variables and Cookies. This kind of information helps tremendously in the bug-tracking process.We wanted to get the variables into a DataTable so that later we could easily bind it to a DataGrid. The variables are either stored in a NameValueCollection or an HttpCookiesCollection, so I wrote a couple of functions that iterate through the collections and add rows to a datatable:


     Private Function GetVariables(ByVal inputVarCollection As System.Collections.Specialized.NameValueCollection) As DataTable
    Dim objTable 
    As New DataTable()
    objTable.Columns.Add("Name"GetType(String))
    objTable.Columns.Add("Value"GetType(String))

    Dim strItem As String
    Dim objRow 
    As DataRow
    For Each strItem In inputVarCollection
    objRow 
    objTable.NewRow()
    objRow("Name") = strItem
    objRow
    ("Value") = inputVarCollection(strItem)
    objTable.Rows.Add(objRow)
    Next

    Return objTable
    End 
    Function

    Private Function 
    GetCookieVars() As DataTable
    Dim objTable 
    As New DataTable()
    objTable.Columns.Add("Name"GetType(String))
    objTable.Columns.Add("Value"GetType(String))

    Dim strItem As String
    Dim objRow 
    As DataRow
    For Each strItem In HttpContext.Current.Request.Cookies
    objRow 
    objTable.NewRow()
    objRow("Name") = strItem
    objRow
    ("Value") = HttpContext.Current.Request.Cookies(strItem).Value
    objTable
    .Rows.Add(objRow)
    Next

    Return objTable
    End 
    Function

    [bold]Creating the DataGrids[/bold]I fashioned the error e-mail after the output generated when you use ASP.NET tracing. The easiest way to do this was to use DataGrids, but since they were all going to be the same design and they needed to be programmatically generated on the fly, I wrote a method that set up the templates for the grid:


    Private Function CreateDataGrid() As System.Web.UI.WebControls.DataGrid

    Dim objDataGrid 
    As New DataGrid()
    objDataGrid.Width System.Web.UI.WebControls.Unit.Percentage(100)
    objDataGrid.BorderWidth System.Web.UI.WebControls.Unit.Pixel(0)
    objDataGrid.CellPadding "2"

    objDataGrid.HeaderStyle.BackColor System.Drawing.Color.LightGray
    objDataGrid
    .HeaderStyle.ForeColor System.Drawing.Color.Black
    objDataGrid
    .HeaderStyle.Font.Name "Arial"
    objDataGrid.HeaderStyle.Font.Size System.Web.UI.WebControls.FontUnit.Point(10)
    objDataGrid.HeaderStyle.Font.Bold True

    objDataGrid
    .ItemStyle.BackColor System.Drawing.Color.White
    objDataGrid
    .ItemStyle.ForeColor System.Drawing.Color.Black
    objDataGrid
    .ItemStyle.Font.Name "Arial"
    objDataGrid.ItemStyle.Font.Size System.Web.UI.WebControls.FontUnit.Point(10)

    objDataGrid.AlternatingItemStyle.BackColor System.Drawing.ColorTranslator.FromHtml("#eeeeee")
    objDataGrid.AlternatingItemStyle.ForeColor System.Drawing.Color.Black
    objDataGrid
    .AlternatingItemStyle.Font.Name "Arial"
    objDataGrid.AlternatingItemStyle.Font.Size System.Web.UI.WebControls.FontUnit.Point(10)

    Return 
    objDataGrid

    End 
    Function

    [bold]Creating the e-mail[/bold]This is the most complicated step of the process and one of the main reasons that we went with the aspNetEmail component. System.Web.Mail didn?t allow us to add controls (like DataGrid) to an e-mail message, so we would have had to build a lot of ugly ASP-like code to generate nice, uniform looking tables. Why reinvent the wheel when there are server controls that do the dirty work for you? We were able to add the DataGrid controls to our e-mail messages using aspNetEmail?s AppendControlToBody function. The code below will add a DataGrid containing cookie information and send the e-mail:


    Dim objMessage As New EmailMessage("your smtp server")

    Dim objCookiesDG As DataGrid CreateDataGrid()
    objCookiesDG.DataSource GetCookieVars()
    objCookiesDG.DataBind()
    objMessage.AppendControlToBody(objCookiesDG)

    objMessage.FromAddress "e-mail address"
    objMessage.To "comma separated e-mail addresses"
    objMessage.Subject "Error: Portal Error"
    objMessage.BodyFormat MailFormat.Html
    objMessage
    .Send()

    [bold]Conclusion[/bold]It is super easy to globally handle and trap errors at an application level, and with a couple of steps, you can create e-mail notification of those errors in a standard, easy to read format. You can view the entire ErrorHandlerClass below:


    Imports System.Text
    Imports aspNetEmail

    Public Class ErrorHandler

    Private Function CreateDataGrid() As System.Web.UI.WebControls.DataGrid

    Dim objDataGrid 
    As New DataGrid()
    objDataGrid.Width System.Web.UI.WebControls.Unit.Percentage(100)
    objDataGrid.BorderWidth System.Web.UI.WebControls.Unit.Pixel(0)
    objDataGrid.CellPadding "2"

    objDataGrid.HeaderStyle.BackColor System.Drawing.Color.LightGray
    objDataGrid
    .HeaderStyle.ForeColor System.Drawing.Color.Black
    objDataGrid
    .HeaderStyle.Font.Name "Arial"
    objDataGrid.HeaderStyle.Font.Size System.Web.UI.WebControls.FontUnit.Point(10)
    objDataGrid.HeaderStyle.Font.Bold True

    objDataGrid
    .ItemStyle.BackColor System.Drawing.Color.White
    objDataGrid
    .ItemStyle.ForeColor System.Drawing.Color.Black
    objDataGrid
    .ItemStyle.Font.Name "Arial"
    objDataGrid.ItemStyle.Font.Size System.Web.UI.WebControls.FontUnit.Point(10)

    objDataGrid.AlternatingItemStyle.BackColor System.Drawing.ColorTranslator.FromHtml("#eeeeee")
    objDataGrid.AlternatingItemStyle.ForeColor System.Drawing.Color.Black
    objDataGrid
    .AlternatingItemStyle.Font.Name "Arial"
    objDataGrid.AlternatingItemStyle.Font.Size System.Web.UI.WebControls.FontUnit.Point(10)

    Return 
    objDataGrid

    End 
    Function

    Private Function 
    GetVariables(ByVal inputVarCollection As System.Collections.Specialized.NameValueCollection) As DataTable
    Dim objTable 
    As New DataTable()
    objTable.Columns.Add("Name"GetType(String))
    objTable.Columns.Add("Value"GetType(String))

    Dim strItem As String
    Dim objRow 
    As DataRow
    For Each strItem In inputVarCollection
    objRow 
    objTable.NewRow()
    objRow("Name") = strItem
    objRow
    ("Value") = inputVarCollection(strItem)
    objTable.Rows.Add(objRow)
    Next

    Return objTable
    End 
    Function

    Private Function 
    GetCookieVars() As DataTable
    Dim objTable 
    As New DataTable()
    objTable.Columns.Add("Name"GetType(String))
    objTable.Columns.Add("Value"GetType(String))

    Dim strItem As String
    Dim objRow 
    As DataRow
    For Each strItem In HttpContext.Current.Request.Cookies
    objRow 
    objTable.NewRow()
    objRow("Name") = strItem
    objRow
    ("Value") = HttpContext.Current.Request.Cookies(strItem).Value
    objTable
    .Rows.Add(objRow)
    Next

    Return objTable
    End 
    Function

    Public 
    Sub SendHtmlErrorEmail(ByVal ex As Exception)
    Dim objMessage As New EmailMessage("your smtp server")

    objMessage.Body "<SPAN STYLE=""font-size:18pt; color: red;font-family: Arial;"">Portal Error - " ex.Message "</SPAN>

    "

    Dim objErrInfoDG As DataGrid CreateDataGrid()

    objMessage.Body &= "<TABLE BORDER=0 WIDTH=100% CELLPADDING=1 CELLSPACING=0><TR><TD STYLE=""background-color: black; color: white;font-weight: bold;font-family: Arial;"">Error information</TD></TR></TABLE>"
    Dim objTable As New DataTable()
    objTable.Columns.Add("Name"GetType(String))
    objTable.Columns.Add("Value"GetType(String))

    Dim objRow As DataRow

    objRow 
    objTable.NewRow()
    objRow("Name") = "Message"
    objRow("Value") = ex.Message
    objTable
    .Rows.Add(objRow)

    objRow objTable.NewRow()
    objRow("Name") = "Source"
    objRow("Value") = ex.Source
    objTable
    .Rows.Add(objRow)

    objRow objTable.NewRow()
    objRow("Name") = "TargetSite"
    objRow("Value") = ex.TargetSite.ToString()
    objTable.Rows.Add(objRow)

    objRow objTable.NewRow()
    objRow("Name") = "StackTrace"
    objRow("Value") = ex.StackTrace
    objTable
    .Rows.Add(objRow)

    objErrInfoDG.DataSource objTable
    objErrInfoDG
    .DataBind()
    objMessage.AppendControlToBody(objErrInfoDG)


    objMessage.Body &= "

    <TABLE BORDER=0 WIDTH=100% CELLPADDING=1 CELLSPACING=0><TR><TD COLSPAN=2 STYLE=""background-color: black; color: white;font-weight: bold;font-family: Arial;"">Querystring Collection</TD></TR></TABLE>"
    Dim objQSDG As DataGrid CreateDataGrid()
    objQSDG.DataSource GetVariables(HttpContext.Current.Request.QueryString)
    objQSDG.DataBind()
    objMessage.AppendControlToBody(objQSDG)


    objMessage.Body &= "

    <TABLE BORDER=0 WIDTH=100% CELLPADDING=1 CELLSPACING=0><TR><TD COLSPAN=2 STYLE=""background-color: black; color: white;font-weight: bold;font-family: Arial;"">Form Collection</TD></TR></TABLE>"
    Dim objFormDG As DataGrid CreateDataGrid()
    objFormDG.DataSource GetVariables(HttpContext.Current.Request.Form)
    objFormDG.DataBind()
    objMessage.AppendControlToBody(objFormDG)


    objMessage.Body &= "

    <TABLE BORDER=0 WIDTH=100% CELLPADDING=1 CELLSPACING=0><TR><TD COLSPAN=2 STYLE=""background-color: black; color: white;font-weight: bold;font-family: Arial;"">Cookies Collection</TD></TR></TABLE>"
    Dim objCookiesDG As DataGrid CreateDataGrid()
    objCookiesDG.DataSource GetCookieVars()
    objCookiesDG.DataBind()
    objMessage.AppendControlToBody(objCookiesDG)


    objMessage.Body &= "

    <TABLE BORDER=0 WIDTH=100% CELLPADDING=1 CELLSPACING=0><TR><TD COLSPAN=2 STYLE=""background-color: black; color: white;font-weight: bold;font-family: Arial;"">Server Variables</TD></TR></TABLE>"
    Dim objServVarDG As DataGrid CreateDataGrid()
    objServVarDG.DataSource GetVariables(HttpContext.Current.Request.ServerVariables)
    objServVarDG.DataBind()
    objMessage.AppendControlToBody(objServVarDG)

    objMessage.FromAddress "e-mail address"
    objMessage.To "comma separated e-mail addresses"
    objMessage.Subject "Error: Portal Error"
    objMessage.BodyFormat MailFormat.Html
    objMessage
    .Send()
    End Sub

    End 
    Class

    [bold]About the Author[/bold]Tyler Peelen is the lead ASP.NET developer for the University of Wisconsin ? Stevens Point, my.uwsp.edu portal project. Although he is only 18, he has a firm grasp of ASP.NET has been programming for 10 years.
    DISCLAIMER: The content provided in this article is not warranted or guaranteed by Developer Shed, Inc. The content provided is intended for entertainment and/or educational purposes in order to introduce to the reader key ideas, concepts, and/or product reviews. As such it is incumbent upon the reader to employ real-world tactics for security and implementation of best practices. We are not liable for any negative consequences that may result from implementing any information covered in our articles or tutorials. If this is a hardware review, it is not recommended to open and/or modify your hardware.

    More ASP.NET Code Articles
    More By Tyler Peelen

     

    IBM® developerWorks developerWorks - FREE Tools!


    NEW! Best Practices: The Integrated Project and Portfolio Management Platform.

    Hear how IBM Rational Project and Portfolio Management integrated solutions help teams put the right tools and processes in place to maximize the effectiveness and efficiency of project teams and ensure that the business vision is being executed correctly. Learn how to automate and integrate requirements prioritization, top-down project planning, communications and controls, and methodology deployment to keep your scope, costs, and schedules under control. Tackle with an end-to-end approach the management of scope and scope changes, usage of methodology to control and empower project teams, and optimization of resources to align activity costs with the overall project plan.
    FREE! Go There Now!


    NEW! BlammoSplat: Build a community Web site of OpenLaszlo animations, Part 3: The community animation

    Learn to enable users to both rate existing animations and to combine existing animations into new snippets. This is the third in a series of three tutorials that chronicle the building of a site that enables collaborative discussion and animation building using Domino and OpenLaszlo.
    FREE! Go There Now!


    NEW! Hacking 101

    Join us for this web seminar to learn how you can defend your web applications from attack. Learn about the 3 most common web application attacks, including how they occur and what can be done to prevent them. We’ll also discuss manual versus automated approaches for scanning and identifying web application vulnerabilities and how IBM Rational AppScan, an automated vulnerability scanner, can help you automate more of what you are doing manually today.
    FREE! Go There Now!


    NEW! IBM Rational AppScan Standard Edition V7.7

    Secure your Web applications with IBM Rational AppScan Standard Edition V7.7, previously known as Watchfire AppScan. This Web application security testing tool automates vulnerability assessments and scans and tests for common Web application vulnerabilities. Visit IBM developerWorks to download a free trial of IBM Rational AppScan Standard Edition V7.7.
    FREE! Go There Now!


    NEW! Improve your build process with IBM Rational Build Forge, Part 1: Create a continuous build and integration environment

    Learn how to implement a build management system that uses and extends your existing automation technologies. This tutorial shows, step-by-step, how to install and configure IBM Rational Build Forge to manage builds for Jakarta Tomcat from source code.
    FREE! Go There Now!


    NEW! The role of integrated requirements management in software delivery

    This paper is about the critical role that a discipline called integrated require­ments management can play in helping to ensure that your business goals and IT investments are continuously aligned—whether you are sourcing, integrat­ing, building or maintaining software. It also looks at ways that automated IBM Rational® products can work together to help you use requirements in the very best way.
    FREE! Go There Now!


    NEW! Understanding Web application security challenges

    As businesses grow increasingly dependent upon Web applications, these complex entities grow more difficult to secure. Most companies equip their Web sites with firewalls, Secure Sockets Layer (SSL), and network and host security, but the majority of attacks are on applications themselves – and these technologies cannot prevent them. This paper explains what you can do to help protect your organization, and it discusses an approach for improving your organization’s Web application security.
    FREE! Go There Now!


    NEW! Using IBM Rational Developer for System z and IBM Rational ClearCase together to manage application development

    Whether you are creating new applications or modifying existing ones, managing integration of new components with traditional z/OS elements is a critical part of building and deploying modern applications. Listen to this webcast to see how IBM can help you optimize your development process using an IDE like Rational Developer for System z that integrates with management tools, such as ClearCase to manage your application development on mainframes.
    FREE! Go There Now!


    NEW! Webcast: Extreme transaction processing with WebSphere Extended Deployment

    In this webcast, you'll get an introduction to the eXtreme Transaction Processing (XTP) features of WebSphere Extended Deployment and the common architectural traits required by XTP applications. See how WebSphere Extended Deployment's ObjectGrid feature provides a state-of-the-art infrastructure for hosting XTP applications.
    FREE! Go There Now!


    NEW! Whitepaper: Achieving consistency between business process models and operational guides

    Explore how Rational and WebSphere software enable enterprise documentation in SOA environments. Specifically, a new integration between IBM WebSphere® Business Modeler and IBM Rational® Method Composer software can help technical writers more easily keep enterprise operations manuals in sync with changes that are made to business processes, resulting in more accurate and timely documentation that benefits the entire enterprise.
    FREE! Go There Now!



    All FREE IBM® developerWorks Tools!

    ASP.NET CODE ARTICLES

    - How to Use the ListBox Control in ASP.NET 2.0
    - How to Load XML Documents in ASP.NET 2.0
    - DataGrid Code
    - ASP.NET Guestbook
    - User Controls and Client Side Scripting
    - ASP.NET Programming with Microsoft's AS...
    - ASP.NET Basics (part 3): Hard Choices
    - ASP.NET Basics (part 2): Not My Type
    - ASP.NET Basics (part 1): Nothing But .Net
    - Directory Tree Browser
    - How to get the confirmation of Yes/No from a...
    - Complete example using custom errors and wri...
    - Paging Certain # records per page .NET style
    - General Methods of formatting and Subtractin...
    - .NET LinkButton web control





    © 2003-2009 by Developer Shed. All rights reserved. DS Cluster 6 Hosted by Hostway
    For more Enterprise Application Development news, visit eWeek