add, élément de httpModules (Schéma des paramètres ASP.NET)
[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. |
É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 |
|
Membre de configuration |
|
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
How to: Lock ASP.NET Configuration Settings
Référence
httpModules, élément (Schéma des paramètres ASP.NET)
system.web, élément (Schéma des paramètres ASP.NET)
clear, élément de httpModules (Schéma des paramètres ASP.NET)
remove, élément de httpModules (Schéma des paramètres ASP.NET)
Concepts
ASP.NET Configuration Overview
ASP.NET Server Controls and Browser Capabilities
Autres ressources
Paramètres de configuration ASP.NET