<httpHandlers> 要素

  • [アーティクル]

受信した要求で指定されている URL と HTTP 動詞に基づいて、その要求を該当する IHttpHandler クラスまたは IHttpHandlerFactory クラスに割り当てます。

<configuration>
   <system.web>
      <httpHandlers>

<httpHandlers>
   <add verb="verb list"         path="path/wildcard"         type="type,assemblyname"        validate="true|false"/>   <remove verb="verb list"            path="path/wildcard"/>   <clear/></httpHandlers>

サブタグ

サブタグ 説明
<add> 動詞またはパスの HttpHandler クラスまたは IHttpHandlerFactory へのマップを指定します。
<remove> 動詞とパスの IHttpHandler クラスへのマップを削除します。<remove> ディレクティブは、先行する <add> ディレクティブの動詞およびパスの組み合わせと正確に一致する必要があります。ワイルドカード文字はサポートされていません。
<clear> 指定した Web.config ファイルで現在設定されているか、指定した Web.config ファイルが継承したすべての IHttpHandler マップを削除します。

解説

<httpHandlers> の設定値は、サブディレクトリによって継承されます。

<add> ディレクティブは、上から下に順次処理されます。複数の <add> サブ要素が同じ動詞とパスの組み合わせを指定している場合は、最後の <add> が他のすべてのサブ要素をオーバーライドします。

Microsoft Internet Information Services (IIS) には、ISAPI に拡張子を割り当てるための IIS 固有の概念があります。このセクション内の特定の拡張子の設定値を有効にするには、IIS 内でその拡張子を ASP.NET ISAPI に割り当てる必要があります。非標準的な拡張子 (.aspx、.asmx、.asax などの拡張子以外) の場合は、ユーザーが IIS を設定する必要があります。

例

ファイル名の拡張子が .New のファイルに対するすべての HTTP 要求を MyHandler.New クラスに割り当て、ファイル名の拡張子が .MyNewFileExtension のファイルに対するすべての HTTP GET 要求および HTTP HEAD 要求を MyHandler.MNFEHandler. クラスへ割り当てる例を次に示します。どちらのクラスも、MyHandler.dll ファイルの MyHandler アセンブリにあります。

<configuration>
   <system.web>
      <httpHandlers>
         <add verb="*" 
              path="*.New" 
              type="MyHandler.New,MyHandler"/>
         <add verb="GET,HEAD" 
              path="*.MyNewFileExtension" 
              type="MyHandler.MNFEHandler,MyHandler.dll"/>
     </httpHandlers>
   <system.web>
</configuration>

必要条件

格納されている場所 : <system.web>

Web プラットフォーム : IIS 5.0、IIS 5.1、IIS 6.0

構成ファイル : Machine.config、Web.config

構成セクション ハンドラ : System.Web.Configuration.HttpHandlersConfigHandler

参照

ASP.NET の構成 | ASP.NET 設定スキーマ