An HTTP Module is a .NET class that executes with each and every page request. You can use an HTTP Module to handle any of the HttpApplication events that you can handle in the Global.asax file.
You are already familiar with some of the HTTP Modules like
- FormsAuthenticationModule handles the Forms authentication
- WindowsAuthenticationModule handles the Windows authentication
- SessionStateModule manages the session state of ASP.net application
- OutputCacheModule deals with output caching
- ProfileModule used for interaction with user profiles
Each HTTP Module subscribes to one or more HttpApplication events. For example, when the HttpApplication object raises its AuthenticateRequest event, the FormsAuthenticationModule executes its code to authenticate the current user.
Below I have included a sample class which implements the IHttpModule interface
In the Init event I have created an EventHandler for the PostAuthorizeRequest event of Http Application
namespace AspNet
{
public class CustomContentModule : IHttpModule
{
public void Init(HttpApplication app)
{
app.PostAuthorizeRequest += new EventHandler(SendRequest);
}
public void SendRequest(Object sender, EventArgs e)
{
HttpApplication app = (HttpApplication)sender;
app.Response.Write("Hi content from HTTP Module
Pay my tax also !!!");
Pay my tax also !!!");
}
public void Dispose() { }
}
}
You can use any of the following events of HTTP Application; the events are raised in the following order:
- BeginRequest
- AuthenticateRequest
- PostAuthenticateRequest
- AuthorizeRequest
- PostAuthorizeRequest
- ResolveRequestCache
- PostResolveRequestCache
After the PostResolveRequestCache event and before the PostMapRequestHandler event, an event handler (which is a page that corresponds to the request URL) is created. When a server is running IIS 7.0 in Integrated mode and at least the .NET Framework version 3.0, the MapRequestHandler event is raised. When a server is running IIS 7.0 in Classic mode or an earlier version of IIS, this event cannot be handled.
- PostMapRequestHandler
- AcquireRequestState
- PostAcquireRequestState
- PreRequestHandlerExecute
The event handler is executed.
- PostRequestHandlerExecute
- ReleaseRequestState
- PostReleaseRequestState
After the PostReleaseRequestState event is raised, any existing response filters will filter the output.
- UpdateRequestCache
- PostUpdateRequestCache
- LogRequest.
This event is supported in IIS 7.0 Integrated mode and at least the .NET Framework 3.0
- PostLogRequest
This event is supported IIS 7.0 Integrated mode and at least the .NET Framework 3.0
- EndRequest
After creating this class add the following entry in Web.config
<httpModules>
<add name="CustomContentModule" type="AspNet.CustomContentModule"/>
httpModules>
Comments