RequestNotification Enum
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Indicates when events and other life-cycle events occur while a HttpApplication request is being processed.
This enumeration supports a bitwise combination of its member values.
public enum class RequestNotification[System.Flags]
public enum RequestNotification[<System.Flags>]
type RequestNotification = Public Enum RequestNotification- Inheritance
- Attributes
Fields
| Name | Value | Description |
|---|---|---|
| BeginRequest | 1 | Indicates that the BeginRequest event was raised for the request and is processing. |
| AuthenticateRequest | 2 | Indicates that the AuthenticateRequest event was raised for the request and is processing. |
| AuthorizeRequest | 4 | Indicates that the AuthorizeRequest event was raised for the request and is processing. |
| ResolveRequestCache | 8 | Indicates that the ResolveRequestCache event was raised for the request and is processing. |
| MapRequestHandler | 16 | Indicates that the MapRequestHandler event was raised for the request and is processing. |
| AcquireRequestState | 32 | Indicates that the AcquireRequestState event was raised for the request and is processing. |
| PreExecuteRequestHandler | 64 | Indicates a point in the application life cycle just before the handler that processes the request is mapped. |
| ExecuteRequestHandler | 128 | Indicates that the handler that is mapped to the requested resource is being invoked to process the request. |
| ReleaseRequestState | 256 | Indicates that the ReleaseRequestState event was raised for the request and is processing. |
| UpdateRequestCache | 512 | Indicates that the UpdateRequestCache event was raised for the request and is processing. |
| LogRequest | 1024 | Indicates that the LogRequest event was raised for the request and is processing. |
| EndRequest | 2048 | Indicates that the EndRequest event was raised for the request and is processing. |
| SendResponse | 536870912 | Indicates that processing of the request is complete and that the response is being sent. |
Examples
The following example shows how to use the RequestNotification enumeration with the CurrentNotification property to determine which event of the current HttpApplication instance is processing the request.
using System;
using System.Data;
using System.Web;
using System.Web.Security;
using System.Web.UI;
// Module that demonstrates one event handler for several events.
namespace Samples
{
public class ModuleExampleTestCS : IHttpModule
{
public ModuleExampleTestCS()
{
// Constructor
}
public void Init(HttpApplication app)
{
app.AuthenticateRequest += new EventHandler(App_Handler);
app.PostAuthenticateRequest += new EventHandler(App_Handler);
app.LogRequest += new EventHandler(App_Handler);
app.PostLogRequest += new EventHandler(App_Handler);
}
public void Dispose()
{
}
// One handler for AuthenticationRequest, PostAuthenticateRequest,
// LogRequest, and PostLogRequest events
public void App_Handler(object source, EventArgs e)
{
HttpApplication app = (HttpApplication)source;
HttpContext context = app.Context;
if (context.CurrentNotification == RequestNotification.AuthenticateRequest)
{
if (!context.IsPostNotification)
{
// Put code here that is invoked when the AuthenticateRequest event is raised.
}
else
{
// PostAuthenticateRequest
// Put code here that runs after the AuthenticateRequest event completes.
}
}
if (context.CurrentNotification == RequestNotification.LogRequest)
{
if (!context.IsPostNotification)
{
// Put code here that is invoked when the LogRequest event is raised.
}
else
{
// PostLogRequest
// Put code here that runs after the LogRequest event completes.
}
}
}
}
}
Imports System.Data
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
' Module that demonstrates one event handler for several events.
Namespace Samples
Public Class ModuleExampleTestVB
Implements IHttpModule
Public Sub New()
' Constructor
End Sub
Public Sub Init(ByVal app As HttpApplication) Implements IHttpModule.Init
AddHandler app.AuthenticateRequest, AddressOf Me.App_Handler
AddHandler app.PostAuthenticateRequest, AddressOf Me.App_Handler
AddHandler app.LogRequest, AddressOf Me.App_Handler
AddHandler app.PostLogRequest, AddressOf Me.App_Handler
End Sub
Public Sub Dispose() Implements IHttpModule.Dispose
End Sub
' One handler for AuthenticationRequest, PostAuthenticateRequest,
' LogRequest, and PostLogRequest events
Public Sub App_Handler(ByVal source As Object, ByVal e As EventArgs)
Dim app As HttpApplication = CType(source, HttpApplication)
Dim context As HttpContext = app.Context
If (context.CurrentNotification = RequestNotification.AuthenticateRequest) Then
If Not (context.IsPostNotification) Then
' Put code here that is invoked when the AuthenticateRequest event is raised.
Else
' PostAuthenticateRequest
' Put code here that runs after the AuthenticateRequest event completes.
End If
End If
If (context.CurrentNotification = RequestNotification.LogRequest) Then
If Not (context.IsPostNotification) Then
' Put code here that is invoked when the LogRequest event is raised.
Else
' PostLogRequest
' Put code here that runs after the LogRequest event completes.
End If
End If
End Sub
End Class
End Namespace
Remarks
The RequestNotification enumeration is used with the CurrentNotification property of the HttpContext class to determine what event in the pipeline is currently processing. To determine when all the handlers for a specific event of the HttpApplication instance have finished processing, use the IsPostNotification property.
The RequestNotification type is introduced in the .NET Framework 3.5. For more information, see Versions and Dependencies.
