Elemento <httpHandlers>

Articolo
04/11/2008

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

Vedere anche

Configurazione ASP.NET | Schema delle impostazioni ASP.NET

Condividi tramite