<httpHandlers> 項目
依據要求中指定的 URL 和 HTTP 動作 (Verb),將內送的要求對應至適當的 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> | 指定 IHttpHandler 或 IHttpHandlerFactory 類別的動作/路徑對應。 |
<remove> | 移除 IHttpHandler 類別的動作/路徑對應。<remove> 指示詞必須完全與先前 <add> 指示詞的動作/路徑組合相符。不支援萬用字元。 |
<clear> | 移除目前所設定或由指定的 Web.config 檔案繼承的所有 IHttpHandler 對應。 |
備註
<httpHandlers> 設定由子目錄繼承。
依由上而下的順序來處理 <add> 指示詞。如果有兩個或更多的 <add> 子項目指定相同的動作/路徑組合,則最後的 <add> 將覆寫其他的組合。
請注意,Microsoft Internet Information Services (IIS) 有它自己對 ISAPI 的對應擴充功能的看法。若要使這個區段中指定的擴充功能的設定生效,該擴充功能必須在 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