Elemento httpModules (Esquema de configuración de ASP.NET)
[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].
Configura los módulos HTTP de una aplicación. Este elemento se puede declarar en cualquier nivel de la jerarquía de configuración.
<httpModules>
<add... />
<remove... />
<clear/>
</httpModules>
Atributos y elementos
En las próximas secciones se 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 necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .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>
El siguiente elemento httpModules predeterminado se configura en el archivo Web.config raíz en la versión 2.0 de .NET Framework.
<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 |
|
Miembro de configuración |
|
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 |
Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0 .NET Framework 1.0, 1.1 ó 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005 |
Vea también
Tareas
How to: Lock ASP.NET Configuration Settings
Referencia
Elemento system.web (Esquema de configuración de ASP.NET)
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)
Conceptos
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities
Otros recursos
Opciones de configuración de ASP.NET