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

例

次の 2 つの例は、 HttpApplication クラスとそのイベントを使用する方法を示しています。 最初の例では、カスタム HTTP モジュールを作成し、それにイベントを接続する方法を示します。 2 番目の例では、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 ファイルの構成設定を変更して、HTTP モジュールについて ASP.NET に通知する必要があります。 次の例は、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 クラスの 1 つのインスタンスは、有効期間内の多くの要求を処理するために使用されます。 ただし、一度に処理できる要求は 1 つだけです。 したがって、メンバー変数を使用して要求ごとのデータを格納できます。

アプリケーションは、 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 イベントの前に、イベント ハンドラー (要求 URL に対応するページ) が作成されます。 サーバーが統合モードで IIS 7.0 を実行していて、少なくとも .NET Framework バージョン 3.0 である場合、MapRequestHandler イベントが発生します。 サーバーが IIS 7.0 をクラシック モードまたは以前のバージョンの IIS で実行している場合、このイベントは処理できません。

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