Partager via

add, élément de httpModules (Schéma des paramètres ASP.NET)

  • Article

Mise à jour : novembre 2007

Ajoute un élément httpModules à une application.

<configuration>, élément
  system.web, élément (Schéma des paramètres ASP.NET)
    httpModules, élément (Schéma des paramètres ASP.NET)
      add, élément de httpModules (Schéma des paramètres ASP.NET)

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut

Description

name

Attribut requis.

Fournit un nom convivial au module, ce qui permet d'associer un gestionnaire d'événements aux événements de module dans le fichier global.asax.

type

Attribut requis.

Spécifie une combinaison class/assembly séparée par des virgules et constituée de jetons de version, de culture et de clé publique. ASP.NET commence par rechercher la DLL d'assembly dans le répertoire \bin privé de l'application, puis dans le cache système des assemblys.

Éléments enfants

Aucun.

Éléments parents

Élément

Description

configuration

Spécifie l'élément racine dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

system.web

Spécifie l'élément racine de la section de configuration ASP.NET.

httpModules

Configure les modules HTTP présents dans une application.

Notes

Les directives add sont traitées de façon séquentielle, par ordre décroissant. Si plusieurs sous-éléments add spécifient la même combinaison verb/path, la dernière balise add se substitue à toutes les autres.

Configuration par défaut

L'élément add par défaut est configuré dans le fichier Machine.config de la version 1.1 du .NET Framework.

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

L'élément add par défaut est configuré dans le fichier Machine.config de la version 1.0 du .NET Framework.

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

L'élément add par défaut suivant est configuré dans le fichier Web.config racine dans le .NET Framework version 2.0.

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

Exemple

L'exemple de code suivant montre comment ajouter un élément httpModules à une application.

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

Informations sur les éléments

Gestionnaire de section de configuration

System.Web.Configuration.HttpModulesSection

Membre de configuration

SystemWebSectionGroup.HttpModules

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Web.config de niveau répertoire virtuel ou physique

Configuration requise

Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0

.NET Framework version 1.0, 1.1 ou 2.0

Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Tâches

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la configuration ASP.NET

Fonctionnalités des contrôles serveur Web ASP.NET et du navigateur

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Référence

httpModules, élément (Schéma des paramètres ASP.NET)

system.web, élément (Schéma des paramètres ASP.NET)

<configuration>, élément

clear, élément de httpModules (Schéma des paramètres ASP.NET)

remove, élément de httpModules (Schéma des paramètres ASP.NET)

System.Configuration

System.Web.Configuration

Autres ressources

Fichiers de configuration ASP.NET

Paramètres de configuration ASP.NET

Paramètres généraux de configuration (ASP.NET)

API de configuration ASP.NET