DefaultHttpHandler

.NET Framework クラス ライブラリ リファレンス

DefaultHttpHandler クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

既定の HTTP ハンドラのプロパティとメソッドを表します。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Class DefaultHttpHandler
    Implements IHttpAsyncHandler, IHttpHandler

Visual Basic (使用法)

Dim instance As DefaultHttpHandler

C#

public class DefaultHttpHandler : IHttpAsyncHandler,
 IHttpHandler

C++

public ref class DefaultHttpHandler : IHttpAsyncHandler,
 IHttpHandler

J#

public class DefaultHttpHandler implements
 IHttpAsyncHandler, IHttpHandler

JScript

public class DefaultHttpHandler implements
 IHttpAsyncHandler, IHttpHandler

解説

DefaultHttpHandler オブジェクトは、送受信両方の要求受け取りが Microsoft Internet Information Services (IIS) バージョン 6.0 を使用して構成されており、要求された拡張に httpHandlers バインディングが明示的に適用されていない場合に、HTTP パイプラインで受信要求を受け取ります。

要求受け取りは、IIS 6.0 で導入されたワイルドカード アプリケーション マッピング機能を使用して設定できます。詳細については、MSDN ライブラリで、ワイルドカード アプリケーション マップを使用した URL のリマップに関する情報を参照してください。

DefaultHttpHandler クラスは、IHttpAsyncHandler インターフェイスを実装して、非同期要求処理を提供します。HTTP ハンドラの概要については、「HTTP ハンドラを使用したカスタム ASP.NET 処理」を参照してください。また、次の情報も参考にしてください。

• 非同期 HTTP ハンドラの作成については、「方法 : 非同期 HTTP ハンドラを作成する」を参照してください。

• HTTP ハンドラの登録については、「方法 : HTTP ハンドラを登録する」を参照してください。

• 同期および非同期の HTTP ハンドラの開発と配置については、「HTTP モジュールを使用した ASP.NET 処理の拡張」を参照してください。

クラスが、DefaultHttpHandler クラスの派生クラスを作成して、カスタマイズされた要求処理を提供できます。DefaultHttpHandler から派生した非同期 HTTP ハンドラは、BeginProcessRequest メソッドをオーバーライドして、要求の処理方法を変更できます。

DefaultHttpHandler では、ASP.NET エラーを使用しません。IIS エラーまたは独自の ISAPI カスタム エラー機構を使用する既存のコンテンツは、変更なしで動作します。

使用例

DefaultHttpHandler クラスの派生を使用して、カスタマイズされた HTTP ハンドラを実装する方法のコード例を次に示します。

Visual Basic

Public Class defaulthttpexampleVB
    Inherits DefaultHttpHandler

    Private _context As HttpContext

    Public Overrides Function
 BeginProcessRequest _
        (ByVal context As HttpContext, _
         ByVal callback As AsyncCallback, _
         ByVal state As Object)
 As IAsyncResult

        Dim ar As New AsyncResultSample(callback,
 state)
        _context = context

        Return (ar)
    End Function

    Public Overrides Sub
 EndProcessRequest(ByVal result As IAsyncResult)
        _context.Response.Write("EndProcessRequest called.")
    End Sub

    ' This method should not be called asynchronously.
    Public Overrides Sub
 ProcessRequest(ByVal context As HttpContext)
        Throw New InvalidOperationException
 _
          ("Asynchronous processing failed.")
    End Sub

    ' Enables pooling when set to true
    Public Overrides ReadOnly
 Property IsReusable() As Boolean
        Get
            Return True
        End Get
    End Property
End Class

' Tracks state between the begin and end calls.
Class AsyncResultSample
    Implements IAsyncResult
    Private callback As AsyncCallback = Nothing
    Private _asyncState As Object
    Private _isCompleted As Boolean

    Friend Sub New(ByVal
 cb As AsyncCallback, ByVal state As
 Object)
        Me.callback = cb
        _asyncState = state
        _isCompleted = False
    End Sub

    Public ReadOnly Property
 AsyncState() As Object _
      Implements IAsyncResult.AsyncState
        Get
            Return _asyncState
        End Get
    End Property

    Public ReadOnly Property
 CompletedSynchronously() _
      As Boolean Implements
 IAsyncResult.CompletedSynchronously
        Get
            Return False
        End Get
    End Property

    Public ReadOnly Property
 AsyncWaitHandle() _
      As WaitHandle Implements IAsyncResult.AsyncWaitHandle
        Get
            Throw New InvalidOperationException
 _
              ("ASP.NET should not use this property .")
        End Get
    End Property

    Public ReadOnly Property
 IsCompleted() _
      As Boolean Implements
 IAsyncResult.IsCompleted
        Get
            Return IsCompleted
        End Get
    End Property

    Friend Sub SetCompleted()
        _isCompleted = True
        If (callback <> Nothing) Then
            callback(Me)
        End If
    End Sub
End Class

C#

public class AsyncDefaultHttpHandler : DefaultHttpHandler
{
    private HttpContext _context;

    public override IAsyncResult BeginProcessRequest(
      HttpContext context, AsyncCallback callback, object state)
    {
        AsyncResultSample ar = new AsyncResultSample(callback,
 state);
        _context = context;

        return ar;
    }

    public override void EndProcessRequest(IAsyncResult
 result)
    {
        _context.Response.Write("EndProcessRequest called.");
    }

    // This method should not be called asynchronously.
    public override void ProcessRequest(HttpContext
 context)
    {
        throw new InvalidOperationException(
                  "Asynchronous processing failed.");
    }

    // Enables pooling when set to true
    public override bool IsReusable
    {
        get { return true;
 }
    }
}

// Tracks state between the begin and end calls.
class AsyncResultSample : IAsyncResult
{
    private AsyncCallback callback = null;
    private Object asyncState;
    private Boolean isCompleted;

    internal AsyncResultSample(AsyncCallback cb, Object state)
    {
        this.callback = cb;
        asyncState = state;
        isCompleted = false;
    }

    public object AsyncState
    {
        get
        {
            return asyncState;
        }
    }

    public bool CompletedSynchronously
    {
        get
        {
            return false;
        }
    }

    public WaitHandle AsyncWaitHandle
    {
        get
        {
            throw new InvalidOperationException(
                      "ASP.NET should not use this property
 .");
        }
    }

    public bool IsCompleted
    {
        get
        {
            return isCompleted;
        }
    }

    internal void SetCompleted()
    {
        isCompleted = true;
        if (callback != null)
        {
            callback(this);
        }
    }

}

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
  System.Web.DefaultHttpHandler

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DefaultHttpHandler メンバ
System.Web 名前空間
その他の技術情報
HTTP ハンドラを使用したカスタム ASP.NET 処理
方法 : HTTP ハンドラを登録する
方法 : 非同期 HTTP ハンドラを作成する

DefaultHttpHandler コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

DefaultHttpHandler クラスの新しいインスタンスを初期化します。

名前空間: System.Web
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New DefaultHttpHandler

C#

public DefaultHttpHandler ()

C++

public:
DefaultHttpHandler ()

J#

public DefaultHttpHandler ()

JScript

public function DefaultHttpHandler ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DefaultHttpHandler クラス
DefaultHttpHandler メンバ
System.Web 名前空間

DefaultHttpHandler プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	IsReusable	DefaultHttpHandler クラスの現在のインスタンスを別の要求が使用できるかどうかを示すブール値を取得します。

プロテクト プロパティ

	名前	説明
	Context	現在の DefaultHttpHandler オブジェクトに関連付けられているコンテキストを取得します。
	ExecuteUrlHeaders	要求と共に転送する要求ヘッダーと要求値のコレクションを取得します。

参照

関連項目

DefaultHttpHandler クラス
System.Web 名前空間

その他の技術情報

HTTP ハンドラを使用したカスタム ASP.NET 処理
方法 : HTTP ハンドラを登録する
方法 : 非同期 HTTP ハンドラを作成する

DefaultHttpHandler メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginProcessRequest	HTTP ハンドラの非同期の呼び出しを開始します。
	EndProcessRequest	非同期処理の終了メソッドを提供します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	OnExecuteUrlPreconditionFailure	実行前の状態が原因で DefaultHttpHandler オブジェクトが要求を処理できない場合に呼び出されます。
	OverrideExecuteUrlPath	現在の要求の対象 URL をオーバーライドします。
	ProcessRequest	DefaultHttpHandler オブジェクトを有効にして、HTTP Web 要求を処理します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

DefaultHttpHandler クラス
System.Web 名前空間

その他の技術情報

HTTP ハンドラを使用したカスタム ASP.NET 処理
方法 : HTTP ハンドラを登録する
方法 : 非同期 HTTP ハンドラを作成する

DefaultHttpHandler メンバ

既定の HTTP ハンドラのプロパティとメソッドを表します。

DefaultHttpHandler データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	DefaultHttpHandler	DefaultHttpHandler クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	IsReusable	DefaultHttpHandler クラスの現在のインスタンスを別の要求が使用できるかどうかを示すブール値を取得します。

プロテクト プロパティ

	名前	説明
	Context	現在の DefaultHttpHandler オブジェクトに関連付けられているコンテキストを取得します。
	ExecuteUrlHeaders	要求と共に転送する要求ヘッダーと要求値のコレクションを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	BeginProcessRequest	HTTP ハンドラの非同期の呼び出しを開始します。
	EndProcessRequest	非同期処理の終了メソッドを提供します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	OnExecuteUrlPreconditionFailure	実行前の状態が原因で DefaultHttpHandler オブジェクトが要求を処理できない場合に呼び出されます。
	OverrideExecuteUrlPath	現在の要求の対象 URL をオーバーライドします。
	ProcessRequest	DefaultHttpHandler オブジェクトを有効にして、HTTP Web 要求を処理します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

DefaultHttpHandler クラス
System.Web 名前空間

その他の技術情報

HTTP ハンドラを使用したカスタム ASP.NET 処理
方法 : HTTP ハンドラを登録する
方法 : 非同期 HTTP ハンドラを作成する