Compartir a través de

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

  • Artículo

Actualización: noviembre 2007

Agrega un elemento httpModules a una aplicación.

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

<add name="ModuleName"
   type=".NET Class, Assembly [,Version=version number]
      [,Culture=culture] [,PublicKeyToken=token]"/>

Atributos y elementos

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

Atributos

Atributo

Descripción

name

Atributo requerido.

Proporciona un nombre descriptivo para el módulo, lo que permite asociar un controlador de eventos para los eventos de módulo dentro del archivo global.asax.

type

Atributo requerido.

Especifica una combinación de clase y ensamblado que incluye la versión, la referencia cultural y la clave pública, separadas por comas. ASP.NET busca primero el archivo DLL del ensamblado en el directorio \bin privado de la aplicación y, a continuación, en la caché de ensamblados del sistema.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento

Descripción

configuration

Especifica el elemento raíz de 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.

httpModules

Configura los módulos HTTP contenidos en una aplicación.

Comentarios

Las directivas de add se procesan en orden secuencial descendente. Si dos o más subetiquetas add especifican la misma combinación de verbo y ruta de acceso, la última add reemplaza a todas las demás.

Configuración predeterminada

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

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

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

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

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

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

Ejemplo

En el siguiente ejemplo de código se muestra cómo agregar un elemento httpModules a una aplicación.

<configuration>
   <system.web>
      <httpModules>
         <add name="OutputCache"
              type="System.Web.Caching.OutputCacheModule, System.Web,
                    Version=1.0.2800.0, Culture=neutral,
                    PublicKeyToken=b03f5f7f11d50a3a"/>
      </httpModules>
   <system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración

System.Web.Configuration.HttpModulesSection

Miembro de configuración

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

.NET Framework versión 1.0, 1.1 ó 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

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

Referencia

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

Elemento system.web (Esquema de configuración de ASP.NET)

Elemento <configuration>

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

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