Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

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)
'Declaration
Public Property IsPostNotification As Boolean

Property Value

Type: System.Boolean
true if custom errors are enabled; otherwise, false.
ExceptionCondition
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

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

Windows Phone 8.1, Windows Phone 8, 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.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.