Elemento httpModules (schema delle impostazioni ASP.NET)

  • Articolo

[Questa documentazione ha solo scopo di anteprima ed è soggetta a modifiche nelle versioni successive. Gli argomenti vuoti sono inclusi come segnaposto.]

Consente di configurare i moduli HTTP all'interno di un'applicazione. Questo elemento può essere dichiarato a qualsiasi livello della gerarchia di configurazione.

<httpModules> 
   <add... />
   <remove... />
   <clear/>
</httpModules>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Nessuno.

Elementi figlio

Elemento

Descrizione

add

Elemento facoltativo.

Aggiunge un elemento httpModules a un'applicazione.

clear

Elemento facoltativo.

Rimuove tutti gli elementi httpModules da un'applicazione.

remove

Elemento facoltativo.

Rimuove un riferimento a un elemento httpModules.

Il valore deve corrispondere esattamente a quello di una direttiva add precedente.

Elementi padre

Elemento

Descrizione

configuration

Specifica l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Specifica l'elemento radice per la sezione di configurazione ASP.NET.

Note

Configurazione predefinita

Nel file Machine.config in .NET Framework versione 1.1 viene configurato l'elemento httpModules predefinito riportato di seguito.

<httpModules>
     <add name="OutputCache" type="System.Web.Caching.OutputCacheModule"/>
     <add name="Session" type="System.Web.SessionState.SessionStateModule"/>
     <add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule"/>
     <add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule"/>
     <add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule"/>
     <add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule"/>
     <add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule"/>
     <add name="ErrorHandlerModule" type="System.Web.Mobile.ErrorHandlerModule, System.Web.Mobile, 
          Version=1.0.5000.0, Culture=neutral, 
          PublicKeyToken=b03f5f7f11d50a3a"/>
</httpModules>

Nel file Machine.config in .NET Framework versione 1.0 viene configurato l'elemento httpModules predefinito riportato di seguito.

<httpModules>
     <add name="OutputCache" type="System.Web.Caching.OutputCacheModule" />
     <add name="Session" type="System.Web.SessionState.SessionStateModule" />
     <add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule" />
     <add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule" />
     <add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule" />
     <add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule" />
     <add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule" />
</httpModules>

L'elemento httpModules predefinito riportato di seguito è configurato nel file Web.config a livello di radice in .NET Framework versione 2.0.

<httpModules>
     <add name="OutputCache" type="System.Web.Caching.OutputCacheModule" />
     <add name="Session" type="System.Web.SessionState.SessionStateModule" />
     <add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule" />
     <add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule" />
     <add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule" />
     <add name="RoleManager" type="System.Web.Security.RoleManagerModule" />
     <add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule" />
     <add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule" />
     <add name="AnonymousIdentification" type="System.Web.Security.AnonymousIdentificationModule" />
     <add name="Profile" type="System.Web.Profile.ProfileModule" />
</httpModules>

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come aggiungere tre riferimenti HttpModuleall'applicazione ASP.NET.

<configuration>
   <system.web>
      <httpModules>
         <add type="System.Web.Caching.OutputCacheModule" 
              name="OutputCache"/>
         <add type="System.Web.SessionState.SessionStateModule" 
              name="Session"/>
         <add type=Selector, selector.dll"
              name="Selector"/>
      </httpModules>
   </system.web>
</configuration>

Informazioni sull'elemento

Gestore della sezione di configurazione

System.Web.Configuration.HttpModulesSection

Membro di configurazione

SystemWebSectionGroup.HttpModules

Percorsi configurabili

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Web.config a livello di directory fisica o virtuale

Requisiti

Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0

.NET Framework versione 1.0, 1.1 o 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vedere anche

Attività

How to: Lock ASP.NET Configuration Settings

Riferimenti

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento <Configuration>

Elemento add per httpModules (schema delle impostazioni ASP.NET)

Elemento clear per httpModules (schema delle impostazioni ASP.NET)

Elemento remove per httpModules (schema delle impostazioni ASP.NET)

System.Configuration

System.Web.Configuration

Concetti

ASP.NET Configuration Overview

ASP.NET Server Controls and Browser Capabilities

Securing Configuration

Configuration Inheritance

Altre risorse

ASP.NET Configuration Files

Impostazioni di configurazione di ASP.NET

Impostazioni di configurazione generali (ASP.NET)

ASP.NET Configuration API