add, élément de providers pour sessionState (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 fournisseur à la collection de fournisseurs de magasins d'état de session.
<add
name="provider name"
type="fully qualified type reference"
/>
Attributs et éléments
Les sections suivantes décrivent les attributs ainsi que les éléments parents et enfants.
Attributs
Attribut |
Description |
|---|---|
name |
Attribut String requis. Spécifie le nom de l'instance de fournisseur. Il s'agit de la valeur utilisée pour l'attribut customProvider de l'élément sessionState pour identifier l'instance de fournisseur comme fournisseur de magasins d'état de session lorsque la valeur Custom est affectée à l'attribut de mode de l'élément sessionState. |
type |
Attribut String requis. Spécifie le type qui implémente la classe de base abstraite SessionStateStoreProviderBase. La valeur doit être une référence qualifiée complète à l'assembly. |
Éléments enfants
Aucun
Éléments parents
Élément |
Description |
|---|---|
configuration |
Élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework. |
system.web |
Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications. |
sessionState |
Configure les paramètres d'état de session pour l'application actuelle. |
providers |
Contient une collection de fournisseurs de magasins d'état de session personnalisés. |
Notes
L'élément add ajoute un fournisseur à la collection de fournisseurs de magasins d'état de session dans l'élément providers. L'élément providers contient une collection de fournisseurs de magasins d'état de session personnalisés. Le fournisseur de magasins d'état de session personnalisé doit hériter de la classe SessionStateStoreProviderBase.
Pour plus d'informations sur l'accès aux valeurs de configuration de l'élément sessionState dans le code d'application et leur modification, consultez ProviderSettingsCollection et Providers.
Exemple
L'exemple de code suivant montre comment utiliser le fichier Web.config d'une application ASP.NET configurée pour utiliser un fournisseur de magasins d'état de session personnalisé. Pour plus d'informations sur l'implémentation d'un fournisseur de magasins d'état de session, et notamment un exemple de fournisseur, consultez Implementing a Session State Store Provider.
<configuration>
<connectionStrings>
<add name="OdbcSessionServices" connectionString="DSN=SessionState;" />
</connectionStrings>
<system.web>
<sessionState
cookieless="true"
regenerateExpiredSessionId="true"
mode="Custom"
customProvider="OdbcSessionProvider">
<providers>
<add name="OdbcSessionProvider"
type="Samples.AspNet.Session.OdbcSessionStateStore"
connectionStringName="OdbcSessionServices"
writeExceptionsToEventLog="false" />
</providers>
</sessionState>
</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 |
Configuration requise |
Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0 Microsoft .NET Framework version 2.0 Microsoft Visual Studio 2003 ou Visual Studio 2005 |
Voir aussi
Tâches
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Référence
providers, élément de sessionState (Schéma des paramètres ASP.NET)
clear, élément de providers pour sessionState (Schéma des paramètres ASP.NET)
remove, élément de providers pour sessionState (Schéma des paramètres ASP.NET)
providers, élément de sessionState (Schéma des paramètres ASP.NET)
sessionState, élément (Schéma des paramètres ASP.NET)
system.web, élément (Schéma des paramètres ASP.NET)
configuration, élément (Schéma des paramètres généraux)
Concepts
Implementing a Session-State Store Provider
ASP.NET Configuration File Hierarchy
Autres ressources
Paramètres généraux de configuration (ASP.NET)
Paramètres de configuration ASP.NET