ハンドラー: <handlers>

[アーティクル]
03/25/2024

概要

<handlers> 要素では、特定のファイル名拡張子または URL に対して登録されるハンドラーを定義します。

ハンドラーはインターネットインフォメーションサービス (IIS) のコンポーネントであり、通常は要求リソースに対する応答を生成するため、特定のコンテンツへの要求を処理するように構成されます。たとえば、ASP.NET Web ページはハンドラーの 1 つの種類です。ハンドラーを使うと、静的ファイルではない情報をユーザーに返す必要があるリソースへの要求を処理できます。 IIS には、静的ファイル、Common Gateway Interface (CGI) アプリケーション、FastCGI アプリケーション、Internet Server API (ISAPI) 拡張機能をサポートするため、複数の異なるハンドラーの種類が用意されています。 ASP.NET では、HTTP ハンドラーインターフェイスを通じて追加のハンドラーの種類のサポートも提供されます。

開発者は特別な処理を実行するカスタムハンドラーを作成でき、それはアプリケーション内でファイル名拡張子を使って識別できます。たとえば、開発者が RSS 形式の XML を作成するハンドラーを作成した場合、アプリケーション内で .rss ファイル名拡張子をカスタムハンドラーにバインドできます。また、開発者は、特定のファイルにマップするハンドラーを作成し、これらのハンドラーをネイティブモジュールとして、または ASP.NET の IHttpHandler インターフェイスとして、実装することもできます。

互換性

バージョン	メモ
IIS 10.0	`<handlers>` 要素は、IIS 10.0 では変更されませんでした。
IIS 8.5	`<handlers>` 要素は、IIS 8.5 では変更されませんでした。
IIS 8.0	`<handlers>` 要素は、IIS 8.0 では変更されませんでした。
IIS 7.5	`<handlers>` 要素は、IIS 7.5 では変更されませんでした。
IIS 7.0	`<handlers>` 要素が IIS 7.0 で導入されました。
IIS 6.0	該当なし

段取り

<handlers> 要素は IIS 7 の既定のインストールに含まれています。

操作方法

統合モードで実行されている IIS 7 アプリケーションで ASP.NET ハンドラーのハンドラーマッピングを作成する方法

インターネットインフォメーションサービス (IIS) マネージャーを開きます。
- Windows Server 2012 または Windows Server 2012 R2 を使用している場合:
  - タスクバーで、[サーバーマネージャー] をクリックし、[ツール]、[インターネットインフォメーションサービス (IIS) マネージャー] の順にクリックします。
- Windows 8 または Windows 8.1 を使用している場合:
  - Windows キーを押しながら文字 X を押し、[コントロールパネル] をクリックします。
  - [管理ツール] をクリックし、[インターネットインフォメーションサービス (IIS) マネージャー] をダブルクリックします。
- Windows Server 2008 または Windows Server 2008 R2 を使用している場合:
  - タスクバーで、[スタート] ボタンをクリックし、[管理ツール]、[インターネットインフォメーションサービス (IIS) マネージャー] の順にクリックします。
- Windows Vista または Windows 7 を使用している場合:
  - タスクバーで、[スタート]、[コントロールパネル] の順にクリックします。
  - [管理ツール] をダブルクリックし、[インターネットインフォメーションサービス (IIS) マネージャー] をダブルクリックします。
[接続] ペインで、ネイティブモジュールを追加するサーバー接続をクリックします。
[ホーム] ペインで、[ハンドラーマッピング] をダブルクリックします。
[操作] ペインで、[マネージドハンドラーの追加] をクリックします。
[マネージドハンドラーの追加] ダイアログボックスで、以下を指定します。
- [要求パス]。マップするファイル名またはファイル名拡張子。
- Type。マネージドハンドラーの型 (クラス) の名前。ハンドラーがアプリケーションの app_code または bin フォルダーで定義されている場合、その型の名前がドロップダウンリストに表示されます。
- 名前。わかりやすい名前。
[OK] をクリックして [マネージドハンドラーの追加] ダイアログボックスを閉じます。

FastCGI のハンドラーマッピングを作成する方法

インターネットインフォメーションサービス (IIS) マネージャーを開きます。
- Windows Server 2012 または Windows Server 2012 R2 を使用している場合:
  - タスクバーで、[サーバーマネージャー] をクリックし、[ツール]、[インターネットインフォメーションサービス (IIS) マネージャー] の順にクリックします。
- Windows 8 または Windows 8.1 を使用している場合:
  - Windows キーを押しながら文字 X を押し、[コントロールパネル] をクリックします。
  - [管理ツール] をクリックし、[インターネットインフォメーションサービス (IIS) マネージャー] をダブルクリックします。
- Windows Server 2008 または Windows Server 2008 R2 を使用している場合:
  - タスクバーで、[スタート] ボタンをクリックし、[管理ツール]、[インターネットインフォメーションサービス (IIS) マネージャー] の順にクリックします。
- Windows Vista または Windows 7 を使用している場合:
  - タスクバーで、[スタート]、[コントロールパネル] の順にクリックします。
  - [管理ツール] をダブルクリックし、[インターネットインフォメーションサービス (IIS) マネージャー] をダブルクリックします。
[接続] ペインで、FastCGI ハンドラーマッピングを構成するサーバー名をクリックします。
[ホーム] ウィンドウで、[ハンドラーマッピング] をダブルクリックします。
[操作] ペインで、[モジュールマッピングの追加] をクリックします。

Note

次の手順を実行するには、指定するファイルパスまたはファイル名拡張子を実行するバイナリが既にインストールされている必要があります。この例では、Microsoft の Web サイトから利用できる PHP の実装を使います。
[要求パス] ボックスにファイル名拡張子 (.php など) を入力し、[モジュール] ドロップダウンリストで [FastCGIModule] をクリックし、[実行可能ファイル] ボックスにスクリプトエンジン (この例では、PHP-CGI.exe) へのパスを入力して、[OK] をクリックします。
[モジュールマッピングの追加] ダイアログボックスで、[はい] をクリックします。

構成

<handlers> 要素には <add> 要素のコレクションが含まれており、それぞれでアプリケーションのハンドラーマッピングが定義されています。 <add> 要素には、ハンドラーの名前、ハンドラーのマップ先のファイル名拡張子または URL パスマスク、ハンドラーの実装を指定するモジュール名または ASP.NET HTTP ハンドラーの種類、その他の設定が含まれています。

<handlers> 要素は、Web.config ファイルにおいてアプリケーションのレベルで構成します。

属性

属性説明

accessPolicy

省略可能なフラグ属性。

ハンドラーコレクション全体に対して許可されるアクセスの種類を指定します。

accessPolicy 属性には、次のいずれかの値を指定できます。既定値は、Read です。

Value	説明
`Execute`	ディレクトリとファイルでの実行権限を必要とする、ハンドラーコレクション内のハンドラーを有効にします。
`None`	ディレクトリまたはファイルへのアクセス権を必要とする、ハンドラーコレクション内のすべてのハンドラーを無効にします。
`NoRemoteExecute`	ハンドラーがリモート要求を受信したときに、ハンドラーコレクション内のハンドラーが実行可能ファイルを実行できないようにします。
`NoRemoteRead`	ハンドラーがリモート要求を受信したときに、ハンドラーコレクション内のハンドラーがファイルを読み取れないようにします。
`NoRemoteScript`	ハンドラーがリモート要求を受信したときに、ハンドラーコレクション内のハンドラーがスクリプトを実行できないようにします。
`NoRemoteWrite`	ハンドラーがリモート要求を受信したときに、ハンドラーコレクション内のハンドラーがファイルを作成または変更できないようにします。
`Read`	ディレクトリとファイルへの読み取りアクセス権を必要とする、ハンドラーコレクション内のハンドラーを有効にします。
`Script`	ディレクトリまたはファイルに対するスクリプト権限を必要とする、ハンドラーコレクション内のハンドラーを有効にします。
`Source`	ソースコードへの読み取りアクセス権 (Read フラグと共に) またはソースコードへの書き込みアクセス権 (Write フラグと共に) を必要とする、ハンドラーコレクション内のハンドラー有効にします。
`Write`	ディレクトリとファイルへの書き込みアクセス権を必要とする、ハンドラーコレクション内のハンドラーを有効にします。

子要素

要素	説明
`add`	省略可能な要素です。ハンドラーのコレクションにハンドラーを追加します。
`clear`	省略可能な要素です。ハンドラーコレクションからハンドラーへのすべての参照を削除します。
`remove`	省略可能な要素です。ハンドラーコレクションからハンドラーへの参照を削除します。

構成サンプル

次の例には、ハンドラーマッピングを定義する 2 つの <add> 要素が含まれています。 1 番目の <add> 要素では、IIS 7 統合モードで実行されている Web アプリケーションの SampleHandler ハンドラーを定義しています。ハンドラーアセンブリを Web アプリケーションの app_code ディレクトリに追加する場合、type 属性の値にアセンブリ名を含める必要はありません。 2 番目の <add> 要素では、FastCGI モジュールを使う PHP 要求のマッピングを定義しています。

<handlers>
   <add name="SampleHandler" verb="*" 
      path="SampleHandler.new" 
      type="SampleHandler, SampleHandlerAssembly" 
      resourceType="Unspecified" />
   <add name="PHP-FastCGI" verb="*" 
      path="*.php" 
      modules="FastCgiModule"
      scriptProcessor="c:\php\php-cgi.exe" 
      resourceType="Either" />
</handlers>

サンプルコード

次の例では、PHP モジュールの FastCGI マッピングを追加してから、PHP 要求を処理するハンドラーを Contoso Web サイトに追加します。

AppCmd.exe

appcmd.exe set config -section:system.webServer/fastCgi /+"[fullPath='c:\php\php-cgi.exe']" /commit:apphost

appcmd.exe set config "Contoso" -section:system.webServer/handlers /+"[name='PHP-FastCGI',path='*.php',verb='GET,HEAD,POST',modules='FastCgiModule',scriptProcessor='c:\php\php-cgi.exe',resourceType='Either']"

Note

この 2 番目の例では、特定の URL に対する SampleHandler.new という名前の新しい ASP.NET ハンドラーマッピングを、Web アプリケーションに追加する方法を示します。

appcmd.exe set config /section:system.webServer/handlers /+[name=SampleHandler',path='SampleHandler.new',verb='*',type='SampleHandler']

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration appHostConfig = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection fastCgiSection = appHostConfig.GetSection("system.webServer/fastCgi");
         ConfigurationElementCollection fastCgiCollection = fastCgiSection.GetCollection();
         ConfigurationElement applicationElement = fastCgiCollection.CreateElement("application");
         applicationElement["fullPath"] = @"c:\php\php-cgi.exe";
         fastCgiCollection.Add(applicationElement);

         Configuration webConfig = serverManager.GetWebConfiguration("Contoso");
         ConfigurationSection handlersSection = webConfig.GetSection("system.webServer/handlers");
         ConfigurationElementCollection handlersCollection = handlersSection.GetCollection();
         ConfigurationElement addElement = handlersCollection.CreateElement("add");
         addElement["name"] = @"PHP-FastCGI";
         addElement["path"] = @"*.php";
         addElement["verb"] = @"GET,HEAD,POST";
         addElement["modules"] = @"FastCgiModule";
         addElement["scriptProcessor"] = @"c:\php\php-cgi.exe";
         addElement["resourceType"] = @"Either";
         handlersCollection.AddAt(0, addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim appHostConfig As Configuration = serverManager.GetApplicationHostConfiguration
      Dim fastCgiSection As ConfigurationSection = appHostConfig.GetSection("system.webServer/fastCgi")
      Dim fastCgiCollection As ConfigurationElementCollection = fastCgiSection.GetCollection
      Dim applicationElement As ConfigurationElement = fastCgiCollection.CreateElement("application")
      applicationElement("fullPath") = "c:\php\php-cgi.exe"
      fastCgiCollection.Add(applicationElement)

      Dim webConfig As Configuration = serverManager.GetWebConfiguration("Contoso")
      Dim handlersSection As ConfigurationSection = webConfig.GetSection("system.webServer/handlers")
      Dim handlersCollection As ConfigurationElementCollection = handlersSection.GetCollection
      Dim addElement As ConfigurationElement = handlersCollection.CreateElement("add")
      addElement("name") = "PHP-FastCGI"
      addElement("path") = "*.php"
      addElement("verb") = "GET,HEAD,POST"
      addElement("modules") = "FastCgiModule"
      addElement("scriptProcessor") = "c:\php\php-cgi.exe"
      addElement("resourceType") = "Either"
      handlersCollection.AddAt(0, addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');

adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var fastCgiSection = adminManager.GetAdminSection("system.webServer/fastCgi", "MACHINE/WEBROOT/APPHOST");
var fastCgiCollection = fastCgiSection.Collection;
var applicationElement = fastCgiCollection.CreateNewElement("application");
applicationElement.Properties.Item("fullPath").Value = "c:\\php\\php-cgi.exe";
fastCgiCollection.AddElement(applicationElement);
adminManager.CommitChanges();

adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso";
var handlersSection = adminManager.GetAdminSection("system.webServer/handlers", "MACHINE/WEBROOT/APPHOST/Contoso");
var handlersCollection = handlersSection.Collection;
var addElement = handlersCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "PHP-FastCGI";
addElement.Properties.Item("path").Value = "*.php";
addElement.Properties.Item("verb").Value = "GET,HEAD,POST";
addElement.Properties.Item("modules").Value = "FastCgiModule";
addElement.Properties.Item("scriptProcessor").Value = "c:\\php\\php-cgi.exe";
addElement.Properties.Item("resourceType").Value = "Either";
handlersCollection.AddElement(addElement, 0);
adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")

adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set fastCgiSection = adminManager.GetAdminSection("system.webServer/fastCgi", "MACHINE/WEBROOT/APPHOST")
Set fastCgiCollection = fastCgiSection.Collection
Set applicationElement = fastCgiCollection.CreateNewElement("application")
applicationElement.Properties.Item("fullPath").Value = "c:\php\php-cgi.exe"
fastCgiCollection.AddElement applicationElement
adminManager.CommitChanges()

adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso"
Set handlersSection = adminManager.GetAdminSection("system.webServer/handlers", "MACHINE/WEBROOT/APPHOST/Contoso")
Set handlersCollection = handlersSection.Collection
Set addElement = handlersCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "PHP-FastCGI"
addElement.Properties.Item("path").Value = "*.php"
addElement.Properties.Item("verb").Value = "GET,HEAD,POST"
addElement.Properties.Item("modules").Value = "FastCgiModule"
addElement.Properties.Item("scriptProcessor").Value = "c:\php\php-cgi.exe"
addElement.Properties.Item("resourceType").Value = "Either"
handlersCollection.AddElement addElement, 0
adminManager.CommitChanges()

次の方法で共有

ハンドラー: <handlers>

概要

互換性

段取り

操作方法

統合モードで実行されている IIS 7 アプリケーションで ASP.NET ハンドラーのハンドラーマッピングを作成する方法

FastCGI のハンドラーマッピングを作成する方法

構成

属性

子要素

構成サンプル

サンプルコード

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

フィードバック

その他のリソース

次の方法で共有

ハンドラー: <handlers>

概要

互換性

段取り

操作方法

統合モードで実行されている IIS 7 アプリケーションで ASP.NET ハンドラーのハンドラー マッピングを作成する方法

FastCGI のハンドラー マッピングを作成する方法

構成

属性

子要素

構成サンプル

サンプル コード

AppCmd.exe

C#

VB.NET

JavaScript

VBScript

フィードバック

その他のリソース

統合モードで実行されている IIS 7 アプリケーションで ASP.NET ハンドラーのハンドラーマッピングを作成する方法

FastCGI のハンドラーマッピングを作成する方法

サンプルコード