Export (0) Print
Expand All

HttpContext.CurrentNotification Property

Gets a RequestNotification value that indicates the current HttpApplication event that is processing.

Namespace:  System.Web
Assembly:  System.Web (in System.Web.dll)

public RequestNotification CurrentNotification { get; internal set; }

Property Value

Type: System.Web.RequestNotification
One of the RequestNotification values.

ExceptionCondition
PlatformNotSupportedException

The operation requires integrated pipeline mode in IIS 7.0 and at least the .NET Framework version 3.0.

The CurrentNotification property requires the integrated pipeline mode in IIS 7.0 and at least the .NET Framework version 3.0. When available, the property returns a RequestNotification value. The value of the CurrentNotification property indicates which event in the HttpApplication instance is currently processing the request.

The CurrentNotification property is not intended to be set. Instead, it is set by IIS 7.0 during the processing of the request in the ASP.NET pipeline. Setting the CurrentNotification property will result in a compilation error.

CurrentNotification is introduced in the .NET Framework version 3.5. For more information, see .NET Framework Versions and Dependencies.

The following example demonstrates how to use the CurrentNotification property to determine what event of the HttpApplication object that is handling the current request is being processed. In the example, the event handler handles several events of the HttpApplication object, and the CurrentNotification property determines what code is invoked for each event being handled.

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.
                }
            }

        }
    }
}

.NET Framework

Supported in: 4.5, 4, 3.5 SP1, 3.0 SP1, 2.0 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft