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

Article
05/27/2012

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

Ajoute un élément httpModules à une application.

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

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

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

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Configuration par défaut

Exemple

Informations sur les éléments

Voir aussi

Tâches

Référence

Concepts

Autres ressources

Ressources supplémentaires