Elemento <httpHandlers>
Consente di eseguire il mapping delle richieste in arrivo con la classe IHttpHandler o IHttpHandlerFactory appropriata, in base all'URL e al verbo HTTP specificati nella richiesta.
<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>
Sottotag
| Sottotag | Descrizione |
|---|---|
| <add> | Specifica il mapping verbo/percorso a una classe IHttpHandler o IHttpHandlerFactory. |
| <remove> | Consente di rimuovere un mapping verbo/percorso a una classe IHttpHandler. La direttiva <remove> deve corrispondere esattamente alla combinazione verbo/percorso di una precedente direttiva <add>. Non è supportato l'utilizzo di caratteri jolly. |
| <clear> | Consente di rimuovere tutti i mapping IHttpHandler attualmente configurati o ereditati dal file Web.config specificato. |
Osservazioni
Le impostazioni <httpHandlers> vengono ereditate da sottodirectory.
Le direttive <add> vengono elaborate in ordine sequenziale dall'alto verso il basso. Se due o più sottoelementi <add> specificano la stessa combinazione verbo/percorso, l'elemento <add> finale esegue l'override di tutti gli altri.
È importante notare che Microsoft Internet Information Services (IIS) prevede un proprio concetto di mapping delle estensioni alle ISAPI. Per fare in modo che le impostazioni relative a una determinata estensione di questa sezione abbiano effetto, in IIS è necessario eseguire il mapping di tale estensione all'ISAPI ASP.NET. Per le estensioni non standard (diverse da ASPX, ASMX, ASAX e così via), l'utente deve configurare IIS.
Esempio
Nell'esempio che segue viene eseguito il mapping di tutte le richieste HTTP di file con estensione .New alla classe MyHandler.New e di richieste HTTP GET e HTTP HEAD di file con estensione .MyNewFileExtension alla classe MyHandler.MNFEHandler. Entrambe le classi si trovano nell'assembly MyHandler incluso nel file MyHandler.dll.
<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>
Requisiti
Contenuto in: <system.web>
Piattaforma Web: IIS 5.0, IIS 5.1, IIS 6.0
File di configurazione: Machine.config, Web.config
Gestore della sezione di configurazione: System.Web.Configuration.HttpHandlersConfigHandler