<httpHandlers> 的 <add> 項目
加入處理常式至應用程式中。處理常式是 IHttpHandler 或 IHttpHandlerFactory 類別,可處理特定 URL 的要求。
<configuration>
<system.web>
<httpHandlers>
<add>
<add verb="verb list"
path="path/wildcard"
type="type,assemblyname"
validate="true|false"/>
必要屬性
屬性 | 說明 |
---|---|
verb | 動作 (Verb) 清單可為逗號分隔的 HTTP 動作清單 (例如,GET、PUT、POST) 或起始指令碼對應 (例如,萬用字元 * [星號])。 |
path | 路徑屬性可包含單一 URL 路徑或簡單萬用字串 (例如,*.aspx)。 |
type | 指定逗號分隔的類別/組件組合。ASP.NET 會先在應用程式的私用 \bin 目錄搜尋組件 DLL,然後在系統組件快取中搜尋。 |
選擇性屬性
屬性 | 說明 |
---|---|
validate | 如果 validate 設定為 false,ASP.NET 就不會嘗試載入類別,直到收到實際的配對要求,如此將可能延遲錯誤而改善啟動時間。 |
備註
<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.HttpHandlersSectionHandler