HttpContext.IsPostNotification Property

 

Gets a value that is the current processing point in the ASP.NET pipeline just after an HttpApplication event has finished processing.

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

Public Property IsPostNotification As Boolean
	Get
	Friend Set
End Property

Property Value

Type: System.Boolean

true if custom errors are enabled; otherwise, false.

Exception Condition
PlatformNotSupportedException

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

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 .NET Framework Versions and Dependencies.

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.

Imports System
Imports System.Data
Imports System.Web
Imports System.Web.Security
Imports System.Web.UI
Imports Microsoft.VisualBasic

' 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

.NET Framework
Available since 2.0
Return to top
Show: