Elemento <add> per <httpHandlers>

Articolo
04/11/2008

Consente di aggiungere un gestore a un'applicazione. Un gestore non è altro che una classe IHttpHandler o IHttpHandlerFactory che elabora le richieste di URL specifici.

<configuration>
   <system.web>
      <httpHandlers>
         <add>

<add verb="verb list"      path="path/wildcard"      type="type,assemblyname"     validate="true|false"/>

Attributi obbligatori

Attributo	Descrizione
verb	L'elenco di verbi può essere separato da virgole o essere un elenco di verbi HTTP, ad esempio "GET, PUT, POST", oppure un mapping di inizio script, ad esempio il carattere jolly * (asterisco).
path	L'attributo path può includere un unico percorso URL o una semplice stringa con caratteri jolly, ad esempio *.aspx.
type	Specifica una combinazione di classi/assembly separati da virgole. In ASP.NET, la DLL dell'assembly viene cercata innanzitutto nella directory privata \bin dell'applicazione e quindi nella cache dell'assembly del sistema.

Attributo facoltativo

Attributo	Descrizione
validate	Se l'attributo validate è impostato su false, in ASP.NET non si tenterà di caricare la classe fino a quando non verrà ricevuta la richiesta corrispondente, ritardando potenzialmente l'errore ma riducendo i tempi di avvio.

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.

In Microsoft Internet Information Services (IIS) viene utilizzato un mapping delle estensioni alle ISAPI specifico. 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, ovvero diverse da ASPX, ASMX, ASAX e così via, è necessario 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.HttpHandlersSectionHandler

Vedere anche

Elemento <httpHandlers> | Configurazione ASP.NET | Schema delle impostazioni ASP.NET

Condividi tramite