Partager via


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

Mise à jour : novembre 2007

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

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

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)
        remove, élément de providers pour sessionState (Schéma des paramètres ASP.NET)

<remove 
   name="provider name"
/>

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

Spécifie le nom de l'instance du fournisseur de magasins d'état de session à supprimer de la collection.

Éléments enfants

Aucun.

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

providers

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

Notes

L'élément remove supprime une référence à un fournisseur de magasins d'état de session hérité de la collection 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 configurer le fichier Web.config d'une application ASP.NET pour qu'elle utilise un fournisseur de magasins d'état de session personnalisé. L'exemple supprime l'objet fournisseur de magasins d'état de session existant nommé OdbcSessionProvider à l'aide de l'élément remove avant d'ajouter le 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>
        <remove name="OdbcSessionProvider" />
        <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

Remove

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

Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Implémentation d'un fournisseur de magasins d'état de session

Sécurisation de l'état de session

Hiérarchie du fichier de configuration ASP.NET et héritage

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Référence

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)

clear, é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)

System.Configuration

System.Web.Configuration

SessionStateSection

ProviderSettingsCollection

Providers

SessionStateStoreProviderBase

Autres ressources

Chiffrement des informations de configuration à l'aide de la configuration protégée

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

Paramètres de configuration ASP.NET

Administration de sites Web ASP.NET

API de configuration ASP.NET