Partager via

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

  • Article

Mise à jour : novembre 2007

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

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

<clear/>

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

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 de la section de configuration ASP.NET.

roleManager

Configure une application pour la gestion des rôles.

providers

Définit une collection de fournisseurs de rôles pour la gestion des rôles.

Notes

L'élément clear supprime toutes les références aux fournisseurs de gestion de rôles hérités, stockés dans l'élément providers, n'autorisant que les fournisseurs de gestion de rôles ajoutés par les éléments add suivants.

L'élément providers définit une collection de fournisseurs de rôles pour la gestion des rôles.

Pour plus d'informations sur l'accès aux valeurs de configuration de l'élément roleManager dans le code d'application et leur modification, consultez RoleManagerSection.

Exemple

L'exemple de code suivant montre comment configurer une application ASP.NET afin qu'elle utilise le fournisseur SqlRoleProvider pour stocker et récupérer des informations sur les rôles. L'élément < clear > supprime le contenu de la collection RoleProviderCollection avant d'ajouter SqlRoleProvider.

<configuration>
  <system.web>
      <roleManager defaultProvider="SqlProvider" 
                   enabled="true"
                   cacheRolesInCookie="true"
                   cookieName=".ASPROLES"
                   cookieTimeout="30"
                   cookiePath="/"
                   cookieRequireSSL="false"
                   cookieSlidingExpiration="true"
                   cookieProtection="All" >
        <providers>
        <clear />
          <add
            name="SqlProvider"
            type="System.Web.Security.SqlRoleProvider"
            connectionStringName="SqlServices" 
            applicationName="SampleApplication" />
            
        </providers>
      </roleManager>
  </system.web>
</configuration>

Informations sur les éléments

Gestionnaire de section de configuration

RoleManagerSection

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

.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

Présentation de la gestion des rôles

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Référence

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

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

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

roleManager, é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

RoleManagerSection

RoleManager

Autres ressources

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

Paramètres de configuration ASP.NET

Référence ASP.NET

Administration de sites Web ASP.NET

API de configuration ASP.NET