Partager via

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

  • Article

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

Contient une collection de fournisseurs de magasins d'état de session personnalisés.

Cet élément est une nouveauté du .NET Framework version 2.0.

<providers>
   <add 
      
      
      
      
   />
   <remove />
   <clear/>
</providers>

Attributs et éléments

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

Attributs

Aucun

Éléments enfants

Élément

Description

Add

Élément facultatif.

Ajoute un fournisseur à la collection de fournisseurs de magasins d'état de session.

clear

Élément facultatif.

Supprime toutes les références aux fournisseurs de magasins d'état de session hérités, n'autorisant que les fournisseurs de magasins d'état de session ajoutés par l'élément add actuel.

Remove

Élément facultatif.

Supprime une référence à un fournisseur de magasins d'état de session hérité de la collection.

Éléments parents

Élément

Description

configuration

Spécifie l'é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.

Notes

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.

Configuration par défaut

L'élément providers par défaut n'est pas configuré explicitement dans le fichier Machine.config ou dans le fichier Web.config racine. Toutefois, il s'agit de la configuration par défaut retournée par l'application.

<sessionState
   <!-- Attribute settings. -->
>
   <providers>
      <clear />
   </providers>
</sessionState>

Exemple

L'exemple de code suivant montre comment configurer le fichier Web.config d'une application ASP.NET pour qu'elle utilise 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

SessionStateSection

Membre de configuration

ProviderSettingsCollection

Providers

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

.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

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

add, élément de providers pour 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)

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

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

configuration, élément (Schéma des paramètres généraux)

System.Configuration

System.Web.Configuration

SessionStateSection

ProviderSettingsCollection

Providers

SessionStateStoreProviderBase

Concepts

Implementing a Session-State Store Provider

Securing Session State

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Autres ressources

Protected Configuration

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

Paramètres de configuration ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API