共用方式為


<httpHandlers> 項目

依據要求中指定的 URL 和 HTTP 動作 (Verb),將內送的要求對應至適當的 IHttpHandlerIHttpHandlerFactory 類別。

<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> 指定 IHttpHandlerIHttpHandlerFactory 類別的動作/路徑對應。
<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

請參閱

ASP.NET 組態 | ASP.NET 設定結構描述