HttpApplication 類別

定義

public ref class HttpApplication : IDisposable, System::ComponentModel::IComponent, System::Web::IHttpAsyncHandler

public class HttpApplication : IDisposable, System.ComponentModel.IComponent, System.Web.IHttpAsyncHandler

type HttpApplication = class
    interface IHttpAsyncHandler
    interface IHttpHandler
    interface IComponent
    interface IDisposable

type HttpApplication = class
    interface IComponent
    interface IDisposable
    interface IHttpAsyncHandler
    interface IHttpHandler

Public Class HttpApplication
Implements IComponent, IDisposable, IHttpAsyncHandler

繼承

Object

HttpApplication

實作

IComponent IDisposable IHttpAsyncHandler IHttpHandler

範例

以下兩個範例說明如何使用該 HttpApplication 類別及其事件。 第一個範例示範如何建立自訂 HTTP 模組並將事件連結到它。 第二個範例示範如何修改 Web.config 檔案。

以下範例示範如何建立自訂 HTTP 模組並將事件連接到 AcquireRequestState HTTP 模組。 HTTP 模組會攔截每個對 Web 應用程式資源的請求，從而讓你能過濾用戶端請求。 任何訂閱事件 HttpApplication 的 HTTP 模組都必須實作該 IHttpModule 介面。

using System;
using System.Web;

namespace Samples.AspNet.CS
{
    public class CustomHTTPModule : IHttpModule
    {
        public CustomHTTPModule()
        {
            // Class constructor.
        }

        // Classes that inherit IHttpModule 
        // must implement the Init and Dispose methods.
        public void Init(HttpApplication app)
        {

            app.AcquireRequestState += new EventHandler(app_AcquireRequestState);
            app.PostAcquireRequestState += new EventHandler(app_PostAcquireRequestState);
        }

        public void Dispose()
        {
            // Add code to clean up the
            // instance variables of a module.
        }

        // Define a custom AcquireRequestState event handler.
        public void app_AcquireRequestState(object o, EventArgs ea)
        {
            HttpApplication httpApp = (HttpApplication)o;
            HttpContext ctx = HttpContext.Current;
            ctx.Response.Write(" Executing AcquireRequestState ");
        }

        // Define a custom PostAcquireRequestState event handler.
        public void app_PostAcquireRequestState(object o, EventArgs ea)
        {
            HttpApplication httpApp = (HttpApplication)o;
            HttpContext ctx = HttpContext.Current;
            ctx.Response.Write(" Executing PostAcquireRequestState ");
        }
    }
}

Imports System.Web

Namespace Samples.AspNet.VB
    Public Class CustomHTTPModule
        Implements IHttpModule

        Public Sub New()

            ' Class constructor.

        End Sub


        ' Classes that inherit IHttpModule 
        ' must implement the Init and Dispose methods.
        Public Sub Init(ByVal app As HttpApplication) Implements IHttpModule.Init

            AddHandler app.AcquireRequestState, AddressOf app_AcquireRequestState
            AddHandler app.PostAcquireRequestState, AddressOf app_PostAcquireRequestState

        End Sub


        Public Sub Dispose() Implements IHttpModule.Dispose

            ' Add code to clean up the
            ' instance variables of a module.

        End Sub


        ' Define a custom AcquireRequestState event handler.
        Public Sub app_AcquireRequestState(ByVal o As Object, ByVal ea As EventArgs)

            Dim httpApp As HttpApplication = CType(o, HttpApplication)
            Dim ctx As HttpContext = HttpContext.Current
            ctx.Response.Write(" Executing AcquireRequestState ")

        End Sub

        ' Define a custom PostAcquireRequestState event handler.
        Public Sub app_PostAcquireRequestState(ByVal o As Object, ByVal ea As EventArgs)

            Dim httpApp As HttpApplication = CType(o, HttpApplication)
            Dim ctx As HttpContext = HttpContext.Current
            ctx.Response.Write(" Executing PostAcquireRequestState ")

        End Sub

    End Class

End Namespace

在自訂 HTTP 模組發生事件之前，您必須修改 Web.config 檔案中的設定，以通知 ASP.NET HTTP 模組的存在。 以下範例展示了 Web.config 檔案中 httpModules 適當的設定。 以下設定適用於 IIS 7.0 經典模式及早期版本的 IIS。

<configuration>
  <system.web>
    <httpModules>
      <add type="Samples.AspNet.CS.CustomHTTPModule"
        name="CustomHttpModule" />
      </httpModules>
  </system.web>
</configuration>

<configuration>
  <system.web>
    <httpModules>
      <add type="Samples.AspNet.VB.CustomHTTPModule"
        name="CustomHttpModule" />
      </httpModules>
  </system.web>
</configuration>

以下設定適用於 IIS 7.0 整合模式。

<configuration>
  <system.webServer>
    <modules>
      <add type="Samples.AspNet.CS.CustomHTTPModule"
        name="CustomHttpModule" />
      </modules>
  </system.webServer>
</configuration>

<configuration>
  <system.webServer>
    <modules>
      <add type="Samples.AspNet.VB.CustomHTTPModule"
        name="CustomHttpModule" />
      <modules>
  </system.webServer>
</configuration>

備註

HttpApplication 類別的實例是在 ASP.NET 基礎架構中建立的，而非由使用者直接建立。 該類別的一個實例 HttpApplication 在其生命週期內會處理許多請求。 然而，它一次只能處理一個請求。 因此，成員變數可用來儲存每個請求的資料。

應用程式會引發事件，這些事件可由自訂模組（實作 IHttpModule 介面）或由 Global.asax 檔案中定義的事件處理程式處理。 實現該 IHttpModule 介面的自訂模組可以放在 App_Code 資料夾或 Bin 資料夾的 DLL 裡。

HttpApplication 於 .NET Framework 3.5 版本中引入。 欲了解更多資訊，請參閱 版本與相依關係。

申請事件依以下順序提出：

1. BeginRequest

2. AuthenticateRequest

3. PostAuthenticateRequest

4. AuthorizeRequest

5. PostAuthorizeRequest

6. ResolveRequestCache

7. PostResolveRequestCache

   事件發生 PostResolveRequestCache 後且事件發生前 PostMapRequestHandler ，會建立一個事件處理程序（即對應請求網址的頁面）。 當伺服器以整合模式運行 IIS 7.0 且至少是 .NET Framework 3.0 版本時，會觸發 MapRequestHandler 事件。 當伺服器以經典模式或較早版本的 IIS 運行 IIS 7.0 時，此事件無法被處理。

8. PostMapRequestHandler

9. AcquireRequestState

10. PostAcquireRequestState

11. PreRequestHandlerExecute

    事件處理器已被執行。

12. PostRequestHandlerExecute

13. ReleaseRequestState

14. PostReleaseRequestState

    事件被觸發後 PostReleaseRequestState ，任何現有的回應過濾器會過濾輸出。

15. UpdateRequestCache

16. PostUpdateRequestCache

17. LogRequest。

    此事件在 IIS 7.0 整合模式及至少 .NET Framework 3.0 中均有支援

18. PostLogRequest

    此活動支援 IIS 7.0 整合模式，至少支援 .NET Framework 3.0

19. EndRequest

另請參閱

• IHttpHandlerFactory
• IHttpHandler
• IHttpModule