Visual C# .NET を使用して ASP.NET HTTP ハンドラを作成する方法

文書翻訳 文書翻訳
文書番号: 308001 - 対象製品
この記事は、以前は次の ID で公開されていました: JP308001
すべて展開する | すべて折りたたむ

目次

概要

この資料では、Visual C# .NET を使用して単純なカスタム HTTP ハンドラを作成する方法を紹介します。ここでは、ハンドラの作成、配布、および構成方法について説明します。

詳細

ハンドラの実装

  1. Microsoft Visual Studio .NET を開きます。Visual C# .NET で、MyHandler という名前の新しいクラス ライブラリ プロジェクトを作成します。
  2. System.Web.dll アセンブリへの参照を設定します。
  3. クラスに以下の命令を追加します。
    using System.Web;
    					
  4. クラスの名前を SyncHandler.cs に変更し、クラス定義にも反映します。
  5. IHttpHandler インターフェイスを実装します。クラス定義は次のように表示されます。
    public class SyncHandler : IHttpHandler
    					
  6. IHttpHandler インターフェイスの IsReusable プロパティと ProcessRequest メソッドを実装します。これは同期ハンドラであるため、IsReusable プロパティには False を返し、ハンドラがプールされないようにします。
    public bool IsReusable
    {
       get {return false;}
    }
    
    public void ProcessRequest(HttpContext context)
    {
       context.Response.Write("Hello from custom handler.");
    }
    					
  7. プロジェクトをコンパイルします。

ハンドラの配置

  1. C:\Inetpub\Wwwroot の下に、Handler という名前の新しいディレクトリを作成します。
  2. 新しく作成した Handler ディレクトリの中に、Bin というサブディレクトリを作成し、C:\Inetpub\Wwwroot\Handler\Bin というパスを生成します。
  3. プロジェクトの Bin\Debug ディレクトリから、MyHandler.dll を C:\Inetpub\Wwwroot\Handler\Bin ディレクトリにコピーします。
  4. 以下の手順に従って、新しい Handler ディレクトリを Web アプリケーションとして指定します。
    1. インターネット サービス マネージャを開きます。
    2. Handler ディレクトリを右クリックし、[プロパティ] をクリックします。
    3. [ディレクトリ] タブで [作成] をクリックします。
  5. 以下の手順に従って、ハンドラのアプリケーション マッピングを作成します。このハンドラでは、*.sync 拡張子に対して、Aspnet_isapi.dll ファイルへのマッピングを作成します。.sync ファイルが要求されるたびに、要求は ASP.NET にルーティングされ、ASP.NET によってハンドラ内のコードが実行されます。
    1. Handler Web アプリケーションを右クリックし、[プロパティ] をクリックします。
    2. [ディレクトリ] タブで [構成] をクリックします。
    3. [追加] をクリックして新しいマッピングを追加します。
    4. [実行ファイル] ボックスに、以下のパスを入力します。

      Microsoft Windows 2000 の場合
      C:\WINNT\Microsoft.NET\Framework\<version#>\Aspnet_isapi.dll
      Microsoft Windows XP の場合
      C:\WINDOWS\Microsoft.NET\Framework\<version#>\Aspnet_isapi.dll
    5. [拡張子] ボックスに、.sync と入力します。
    6. [ファイルの存在を確認する] チェック ボックスがオフになっていることを確認し、[OK] をクリックして [アプリケーションの拡張子マッピングの追加/編集] ダイアログ ボックスを閉じます。
    7. [OK] をクリックして [アプリケーションの構成] ダイアログ ボックスと [Handler のプロパティ] ダイアログ ボックスを閉じます。
  6. インターネット サービス マネージャを閉じます。

システムの構成

  1. C:\Inetpub\Wwwroot\Handler ディレクトリの中に、Web.config という名前の新しいファイルを作成します。
  2. Web.config に以下のコードを追加します。
    <configuration>
       <system.web>
          <httpHandlers>
             <add verb="*" path="*.sync" type="MyHandler.SyncHandler, MyHandler" />
          </httpHandlers>
       </system.web>
    </configuration>
    						
    verb="*" 属性は、ハンドラがすべての動詞 (たとえば、POST、HEAD、GET など) を使用する要求を処理することを示します。このハンドラに POST 要求のみを処理させる場合は、これを verb="POST" に変更します。

    path="*.sync" 属性は、ハンドラが .sync 拡張子のファイルに対するすべての要求を処理することを示します。

    type="MyHandler.SyncHandler, MyHandler" 属性は、要求を処理するハンドラが MyHandler.SyncHandler 名前空間に実装され、このクラスが MyHandler アセンブリに含まれていることを示します。

モジュールのテスト

ハンドラをテストする場合、ファイル システム内にページが存在している必要はありません。たとえば、Handler Web アプリケーション内の Default.sync ファイルを要求する (http://<ComputerName>/Handler/Default.sync) と、次のような結果になります。
Hello from custom handler.
				

関連情報

HTTP ハンドラの関連情報を参照するには、以下の「サポート技術情報」 (Microsoft Knowledge Base) をクリックしてください。
307985 [INFO] ASP.NET の HTTP モジュールと HTTP ハンドラの概要

プロパティ

文書番号: 308001 - 最終更新日: 2006年1月24日 - リビジョン: 3.5
この資料は以下の製品について記述したものです。
  • Microsoft ASP.NET 1.1
  • Microsoft ASP.NET 1.0
  • Microsoft Visual C# .NET 2003 Standard Edition
  • Microsoft Visual C# .NET 2002 Standard Edition
キーワード:?
kbconfig kbhowtomaster kbhttphandlers kbhttpruntime kbweb KB308001
"Microsoft Knowledge Baseに含まれている情報は、いかなる保証もない現状ベースで提供されるものです。Microsoft Corporation及びその関連会社は、市場性および特定の目的への適合性を含めて、明示的にも黙示的にも、一切の保証をいたしません。さらに、Microsoft Corporation及びその関連会社は、本文書に含まれている情報の使用及び使用結果につき、正確性、真実性等、いかなる表明・保証も行ないません。Microsoft Corporation、その関連会社及びこれらの権限ある代理人による口頭または書面による一切の情報提供またはアドバイスは、保証を意味するものではなく、かつ上記免責条項の範囲を狭めるものではありません。Microsoft Corporation、その関連会社 及びこれらの者の供給者は、直接的、間接的、偶発的、結果的損害、逸失利益、懲罰的損害、または特別損害を含む全ての損害に対して、状況のいかんを問わず一切責任を負いません。(Microsoft Corporation、その関連会社 またはこれらの者の供給者がかかる損害の発生可能性を了知している場合を含みます。) 結果的損害または偶発的損害に対する責任の免除または制限を認めていない地域においては、上記制限が適用されない場合があります。なお、本文書においては、文書の体裁上の都合により製品名の表記において商標登録表示、その他の商標表示を省略している場合がありますので、予めご了解ください。"

フィードバック

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com