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

Article
09/04/2008

Mise à jour : novembre 2007

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

configuration, élément (Schéma des paramètres généraux)
  system.web, élément (Schéma des paramètres ASP.NET)
    sessionState, élément (Schéma des paramètres ASP.NET)
      providers, élément de sessionState (Schéma des paramètres ASP.NET)
        add, élément de providers pour sessionState (Schéma des paramètres ASP.NET)

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

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 Implémentation d'un fournisseur de magasins d'état de session.

<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	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 Microsoft .NET Framework version 2.0 Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Partager via

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

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Exemple

Informations sur les éléments

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires