Partager via

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

  • Article

Mise à jour : novembre 2007

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

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)

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

Attributs et éléments

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

Attributs

Aucun.

Éléments enfants

Élément

Description

add

Élément facultatif.

Ajoute une instance du fournisseur de rôles à la collection de fournisseurs de gestion des rôles.

clear

Élément facultatif.

Supprime toutes les références à des fournisseurs de gestion des rôles hérités, n'autorisant que ceux qui sont ajoutés par l'élément add actuel.

remove

Élément facultatif.

Supprime une référence à un fournisseur hérité de la collection de fournisseurs de gestion des rôles.

Éléments parents

Élément

Description

configuration

Élément racine obligatoire de 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.

Notes

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 et la modification de valeurs de configuration de l'élément roleManager dans le code d'application, consultez la classe RoleManagerSection ainsi que les fournisseurs de rôles suivants : WindowsTokenRoleProvider, SqlRoleProvider.

Configuration par défaut

L'élément element par défaut suivant est configuré dans le fichier de configuration machine.

<roleManager>
   <providers>
      <add name="AspNetSqlRoleProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
        <add name="AspNetWindowsTokenRoleProvider" applicationName="/" type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
   </providers>
</roleManager>

Exemple

L'exemple suivant montre une application ASP.NET configurée pour utiliser SqlRoleProvider pour stocker et récupérer des informations de rôle.

<configuration>
  <system.web>
      <roleManager defaultProvider="SqlProvider" 
                   enabled="true"
                   cacheRolesInCookie="true"
                   cookieName=".ASPROLES"
                   cookieTimeout="30"
                   cookiePath="/"
                   cookieRequireSSL="false"
                   cookieSlidingExpiration="true"
                   cookieProtection="All" >
        <providers>
          <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 de niveau racine

Web.config de niveau application

Configuration requise

IIS 5.0, IIS 5.1 ou IIS 6.0

.NET Framework 2.0

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

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

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

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

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