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

Article
09/04/2008

Mise à jour : novembre 2007

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

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

<add name="provider name" 
     type="string"
     connectionStringName="string"
     applicationName="string" 
     commandTimeout="number" 
     description="string" 
     cacheRefreshInterval="number" 
     scopeName="string"/>

Attributs et éléments

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

Attributs

Attribut	Description
applicationName	Attribut String facultatif. Spécifie le nom de l'application sous laquelle les noms de rôles sont stockés dans la source de données. Le nom d'application permet à plusieurs applications ASP.NET d'utiliser la même base de données sans rencontrer de noms de rôles en double pour des applications différentes. Plusieurs applications ASP.NET peuvent également utiliser les mêmes informations de rôle en spécifiant le même nom d'application. Les fournisseurs de rôles inclus avec le .NET Framework utilisent la valeur ApplicationVirtualPath pour la propriété ApplicationName si cet attribut n'est pas spécifié.
cacheRefreshInterval	Attribut Int32 facultatif. Spécifie l'intervalle, en minutes, entre des mises à jour forcées des données de magasin de stratégies mises en cache et s'applique uniquement au AuthorizationStoreRoleProvider. La valeur par défaut est 60.
commandTimeout	Attribut Int32 facultatif. Spécifie le nombre de secondes avant l'expiration du délai imparti à une commande envoyée à la source de données du gestionnaire de rôles. Ce délai est utilisé par le fournisseur SQL lors de la création d'objets SqlCommand. Par défaut, cet attribut n'est pas défini dans la configuration ASP.NET. En conséquence, la valeur par défaut ADO.NET de 30 secondes est utilisée. Si cet attribut est défini, le fournisseur SQL utilise la valeur du délai d'expiration configurée pour toutes les commandes SQL envoyées à la base de données. La valeur par défaut est 30 (valeur par défaut ADO.NET).
connectionStringName	Attribut String requis. Spécifie le nom d'une chaîne de connexion définie dans l'élément < connectionStrings >. La chaîne de connexion spécifiée sera utilisée par le fournisseur qui est ajouté.
description	Attribut String facultatif. Spécifie une description de l'instance de fournisseur de rôles.
name	Attribut String requis. Spécifie le nom de l'instance de fournisseur. C'est la valeur utilisée pour l'attribut defaultProvider de l'élément <roleManager> pour identifier l'instance de fournisseur comme fournisseur de rôles par défaut. L'élément name du fournisseur est également utilisé pour indexer le fournisseur dans la collection Providers.
scopeName	Attribut String facultatif. Spécifie la portée de sécurité d'un magasin de stratégies du Gestionnaire d'autorisations auquel l'instance de fournisseur doit se connecter et s'applique uniquement au AuthorizationStoreRoleProvider. Si scopeName est spécifié, la combinaison de applicationName et de scopeName est utilisée par le fournisseur lors de la connexion au magasin de stratégies.
type	Attribut String requis. Spécifie le type qui implémente la classe de base abstraite RoleProvider.

É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 add ajoute une instance de fournisseur de rôles à la collection de fournisseurs de gestion de rôles stockée dans l'élément providers.

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, WindowsTokenRoleProvider, SqlRoleProvider et AuthorizationStoreRoleProvider.

Configuration par défaut

L'élément providers par défaut suivant est configuré dans le fichier Machine.config.

<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 de code suivant indique comment configurer une application ASP.NET afin qu'elle utilise la classe SqlRoleProvider pour stocker et récupérer des informations sur les rôles.

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

Partager via

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

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Configuration par défaut

Exemple

Informations sur les éléments

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires