共用方式為


<httpHandlers> 的 <add> 項目

加入處理常式至應用程式中。處理常式是 IHttpHandlerIHttpHandlerFactory 類別,可處理特定 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

請參閱

<httpHandlers> 項目 | ASP.NET 組態 | ASP.NET 設定結構描述