Elemento httpModules (Esquema de configuración de ASP.NET)

Configura los módulos HTTP de una aplicación. Este elemento se puede declarar en cualquier nivel de la jerarquía de configuración.

Elemento <configuration>
  Elemento system.web (Esquema de configuración de ASP.NET)
    Elemento httpModules (Esquema de configuración de ASP.NET)

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

Atributos y elementos

Las secciones siguientes describen los atributos, los elementos secundarios y los elementos primarios..

Atributos

Ninguno.

Elementos secundarios

Elemento Descripción

add

Elemento opcional.

Agrega un elemento httpModules a una aplicación.

clear

Elemento opcional.

Quita todos los elementos httpModules de una aplicación.

remove

Elemento opcional.

Quita una referencia a un elemento httpModules.

El valor debe coincidir exactamente con el de una directiva add anterior.

Elementos primarios

Elemento Descripción

configuration

Especifica el elemento raíz requerido en cada archivo de configuración usado por Common Language Runtime y las aplicaciones .NET Framework.

system.web

Especifica el elemento raíz de la sección de configuración de ASP.NET.

Comentarios

Configuración predeterminada

En la versión 1.1 de .NET Framework, el siguiente elemento httpModules predeterminado se configura en el archivo Machine.config.

<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>

En la versión 1.0 de .NET Framework, el siguiente elemento httpModules predeterminado se configura en el archivo Machine.config.

<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>

En la versión 2.0 de .NET Framework, el siguiente elemento httpModules predeterminado se configura en el archivo Web.config raíz.

<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>

Ejemplo

En el siguiente ejemplo de código se muestra cómo agregar tres referencias HttpModule a la aplicación 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>

Información de elemento

Controlador de la sección de configuración

System.Web.Configuration.HttpModulesSection

Miembro de configuración

System.Web.Configuration.SystemWebSectionGroup.HttpModules

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Web.config del nivel de directorio virtual o físico

Requisitos

Servicios de Microsoft Internet Information Server (IIS) versión 5.0, 5.1 o 6.0

.NET Framework versión 1.0, 1.1 o 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

Cómo: Bloquear los valores de configuración de ASP.NET

Referencia

Elemento system.web (Esquema de configuración de ASP.NET)
Elemento <configuration>
Elemento add para httpModules (Esquema de configuración de ASP.NET)
Elemento clear para httpModules (Esquema de configuración de ASP.NET)
Elemento remove para httpModules (Esquema de configuración de ASP.NET)
System.Configuration
System.Web.Configuration

Conceptos

Información general sobre la configuración de ASP.NET
Controles de servidor Web ASP.NET y funciones del explorador
Proteger la configuración de ASP.NET
Escenarios de configuración de ASP.NET

Otros recursos

Archivos de configuración de ASP.NET
Opciones de configuración de ASP.NET
Opciones de configuración generales (ASP.NET)
API de configuración de ASP.NET