Click here to Skip to main content
12,547,793 members (37,318 online)
Click here to Skip to main content
Add your own
alternative version


50 bookmarked

An HTTP Module for ASP.NET Error Handling

, 31 Oct 2006
Rate this:
Please Sign up or sign in to vote.
A simple HTTP module to be used as a "last-resort" error handler for ASP.NET applications. It does not require changes to existing code, and can be "dropped-in" to an already running site.


I wrote this HTTP module for a client to plug in an existing site which was having intermittent errors while undergoing integration testing. The client wanted something that could capture the basic error information along with the request query-string/form parameters and write it out. All this needed to be done without modifying the existing code.

Although the existing code did have regular try-catch error handlers in the code-behind files, not all errors were handled properly, and in some cases, the code in the catch block itself was error-prone. Initially, I thought of using a custom error page. However, in view of issues regarding getting the correct context of errors, I decided to use an HTTP module.

The code

The code itself is pretty straightforward.

Step 1 is to wire an event handler for the Error event:

public void Init (HttpApplication app)
   app.Error += new System.EventHandler (OnError);

Step 2 involves writing the actual event handler to write out the error message and the request form / query-string parameters:

public void OnError (object obj, EventArgs args)
   // At this point we have information about the error
   HttpContext ctx = HttpContext.Current;
   HttpResponse response = ctx.Response;
   HttpRequest request = ctx.Request;

   Exception exception = ctx.Server.GetLastError();

   response.Write("Your request could not processed. " + 
                  "Please press the back button on" + 
                  " your browser and try again.<br/>");
   response.Write("If the problem persists, please " + 
                  "contact technical support<p/>");
   response.Write("Information below is for " + 
                  "technical support:<p/>");
   string errorInfo = "<p/>URL: " + ctx.Request.Url.ToString (); 
  errorInfo += "<p/>Stacktrace:---<br/>" + 
  errorInfo += "<p/>Error Message:<br/>" + 

   //Write out the query string 

   for(int i=0;i<request.QueryString.Count;i++)
    response.Write("<br/>" + 
         request.QueryString.Keys[i].ToString() + " :--" + 
         request.QueryString[i].ToString() + "--<br/>");// + nvc.

   //Write out the form collection
   response.Write("<p>---------------" + 

   for(int i=0;i<request.Form.Count;i++)
    response.Write("<br/>" + 
             request.Form.Keys[i].ToString() + 
             " :--" + request.Form[i].ToString() + 
             "--<br/>");// + nvc.

   response.Write("<p>-----------------" + 

   response.Write (errorInfo);

   // --------------------------------------------------
   // To let the page finish running we clear the error
   // --------------------------------------------------
   ctx.Server.ClearError ();


To deploy this HTTP module, simply drop the compiled DLL in the bin folder and make this entry in the web.config to register it:


    <!--<span class="code-comment"> Add the lines below to register the http module --></span>    
        <add type="MyApps.Utilities.GlobalErrorHandler,
                name="GlobalErrorHandler" />



You can download the complete source code (.cs file), a sample web.config, and the compiled DLL in a single zip file from the link above.

Further Improvements

This code was really a result of a couple of hours work, so it can obviously be refined. A few changes I am already considering: make the display text dynamic and the overall display more customizable via web.config. In addition, an option to email or log the error messages would be useful. I will be posting updated code in the next few weeks.


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Web Developer
United States United States
Eeraj is a software developer working in the USA. He has over 10 years of experience and his interests include ASP.NET, JavaScript, C#, Data Mining and Business Intelligence. You can visit his website at

You may also be interested in...


Comments and Discussions

SuggestionGood stuff Pin
Christopher Andrews18-Nov-15 0:53
memberChristopher Andrews18-Nov-15 0:53 
QuestionNot handling the unhandled Error Pin
Senthilaan13-Jul-14 21:59
memberSenthilaan13-Jul-14 21:59 
GeneralMy vote of 5 Pin
arindamrudra5-Jul-12 23:53
memberarindamrudra5-Jul-12 23:53 
GeneralIIS 7.5 .Error event not firing Pin
ilia.broudno15-Feb-11 8:49
memberilia.broudno15-Feb-11 8:49 
GeneralRe: IIS 7.5 .Error event not firing Pin
GamleKoder4-Apr-12 8:11
memberGamleKoder4-Apr-12 8:11 
QuestionI am gettting the following error which using the code Pin
Prakash.SE5-Jul-07 22:41
memberPrakash.SE5-Jul-07 22:41 
GeneralThis is a lot simple and shorter then yours... Pin
hakervytas16-Mar-07 5:08
memberhakervytas16-Mar-07 5:08 
Generalthank you very much Pin
riali27-Nov-06 10:54
memberriali27-Nov-06 10:54 
QuestionWhich references should I load Pin
riali27-Nov-06 7:45
memberriali27-Nov-06 7:45 
AnswerRe: Which references should I load Pin
eeraj27-Nov-06 8:16
membereeraj27-Nov-06 8:16 
Questionmaking a dll Pin
riali25-Nov-06 3:59
memberriali25-Nov-06 3:59 
AnswerRe: making a dll Pin
eeraj27-Nov-06 4:48
membereeraj27-Nov-06 4:48 
GeneralThe idea is sound but the implementation is potentially a security flaw Pin
leapoflogic7-Nov-06 10:10
memberleapoflogic7-Nov-06 10:10 
GeneralRe: The idea is sound but the implementation is potentially a security flaw Pin
eeraj7-Nov-06 10:21
membereeraj7-Nov-06 10:21 
GeneralRe: The idea is sound but the implementation is potentially a security flaw Pin
leapoflogic7-Nov-06 10:39
memberleapoflogic7-Nov-06 10:39 
GeneralThere is a ready solution from microsoft Pin
Evyatar Ben-Shitrit6-Nov-06 22:10
memberEvyatar Ben-Shitrit6-Nov-06 22:10 
GeneralRe: There is a ready solution from microsoft Pin
eeraj7-Nov-06 3:40
membereeraj7-Nov-06 3:40 
Generalgood Pin
dino66631-Oct-06 17:46
memberdino66631-Oct-06 17:46 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.161018.1 | Last Updated 31 Oct 2006
Article Copyright 2006 by eeraj
Everything else Copyright © CodeProject, 1999-2016
Layout: fixed | fluid