Partager via


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

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

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

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

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

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

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

Concepts

Understanding ASP.NET Role Management

Securing Configuration

Configuration Inheritance

Autres ressources

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

Paramètres de configuration ASP.NET

Référence ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API