But I have never really found a full answer. I'm gonna try to give a full one!
First, be aware, that there are many ways to catch the SharePoint errors, but to my knowledge, only this one is fully supporter by Microsoft, cause it uses an HTTPModule which is a supported way of working!
1/ Create your HTTPModule
The class you are about to create inherits System.Web.IHttpModule
During the Init of the module, add an event handler that will listen to the Error. It should be something like
And now declare your event handler function:
I was basically doing it differently, using an arrey of AllErrors, but it didn't give always the good exception, so I used a part of the code created by Anupam Ranku on his blog http://www.codeproject.com/KB/sharepoint/Handling_Error_Centrally.aspx.
From him, I took the fact that using
I was directly going to the first innerexception. Simple and efficient !!!
2/ Create an Error page
On the Page_Load of this page, just verify that the last exception exists
Design your page the way you want it to be!
3/ Modify your web.config
For this, let's assume that you have created a feature, and you have already a classe inheriting
So of course you have already created your 4 overidden functions (
The FeatureActivated method will be launched after activation of the feature (smart name for a method that do so!!!), so what you want to do is to add your http module to the web.config (Carreful: it must be added to ALL the web servers of your farm), to do this let's use this :
What is this AddNewHttpModule function?? Calmos papillons! it's coming!
So this method basically add to the web.config the HttpModule you just created... BUT... one last thing but not the least... This SPWebConfigModification is something really interesting...with one limit, it only add the Modification at the end of the list and for error handling, the httpmodule you enter must be put at the beginning of the httpmodule section of the web.config.... So far, I didn't manage to do it programmatically....so manually, i have to go inside each web.config to cut/paste the new line... (sigh)....
To conclude, See the image of my VS project, in order to understand the wya the project is built (I'm addicted to WSPBuilder!)
4/ Addendum -April 2009 - Catch WebParts Error
So far, the feature worked almost perfectly. I only add one issue with Webpart errors. SharePoint, on the error page sometime add a link to go to the Webpart management page. The HttpModule can't see the difference between those kind of errors and others...(until now) !!
I have added a function in the httpModule that recognize whether an exception has been thrown from a webpart or not... here it is!
At the end of the Application_Error method, just add a new Application variable :
In your error page, you just have to add a if then else, to manage this case.