HttpContext.IsPostNotification Property
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.
Gets a value that is the current processing point in the ASP.NET pipeline just after an HttpApplication event has finished processing.
public:
property bool IsPostNotification { bool get(); };public bool IsPostNotification { get; }member this.IsPostNotification : boolPublic ReadOnly Property IsPostNotification As BooleanProperty Value
true if custom errors are enabled; otherwise, false.
Exceptions
The operation requires the integrated pipeline mode in IIS 7.0 and at least the .NET Framework 3.0.
Examples
The following example demonstrates how to use the IsPostNotification property to determine when an event of the HttpApplication object has finished processing all the associated event handlers. The custom event handler in this example handles several events of the HttpApplication object, and the IsPostNotification property is used to determine what code is invoked after a specific event is 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.
}
}
}
}
}
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 IsPostNotification property is only supported with the integrated mode in IIS 7.0 and at least the .NET Framework 3.0. When available, the property returns a Boolean value that indicates whether an event in the HttpApplication object has finished processing.
The IsPostNotification property is not intended to be set. Instead, it is provided by IIS 7.0 to the ASP.NET runtime for each notification. Setting the IsPostNotification property will result in a compilation error.
In scenarios where multiple events of the HttpApplication object are handled by one event handler, you can use the IsPostNotification property in combination with the RequestNotification enumeration to precisely determine where in the application lifecycle the current request is.
IsPostNotification is introduced in the .NET Framework version 3.5. For more information, see Versions and Dependencies.
