SqlRoleProvider Classe

Définition

Gère le stockage des informations d'appartenance aux rôles pour une application ASP.NET dans une base de données SQL Server.Manages storage of role membership information for an ASP.NET application in a SQL Server database.

public ref class SqlRoleProvider : System::Web::Security::RoleProvider
public class SqlRoleProvider : System.Web.Security.RoleProvider
type SqlRoleProvider = class
    inherit RoleProvider
Public Class SqlRoleProvider
Inherits RoleProvider
Héritage
SqlRoleProvider

Exemples

L’exemple suivant montre le fichier Web. config d’une application ASP.NET configurée pour utiliser SqlRoleProvider un objet et SqlMembershipProviderle.The following example shows the Web.config file for an ASP.NET application configured to use a SqlRoleProvider object and the SqlMembershipProvider. L’élément est configuré pour autoriser uniquement l’accès aux utilisateurs authentifiés dans le rôle Administrateurs.The element is configured to only allow access to authenticated users in the Administrators role.

<configuration>  
  <connectionStrings>  
    <add name="SqlServices" connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=aspnetdb;" />  
  </connectionStrings>  
  <system.web>  
    <authentication mode="Forms" >  
      <forms loginUrl="logincs.aspx"  
      name=".ASPXFORMSAUTH" />  
    </authentication>  
    <authorization>  
      <deny users="?" />  
         <allow roles="Administrators" />  
         <deny users="*" />  
    </authorization>  
    <membership defaultProvider="SqlProvider" userIsOnlineTimeWindow="15">  
      <providers>  
        <add   
          name="SqlProvider"   
          type="System.Web.Security.SqlMembershipProvider"   
          connectionStringName="SqlServices"  
          enablePasswordRetrieval="false"  
          enablePasswordReset="false"  
          requiresQuestionAndAnswer="false"   
          passwordFormat="Hashed"   
          applicationName="SampleApplication" />  
      </providers>  
    </membership>  
    <roleManager defaultProvider="SqlProvider"   
      enabled="true"  
      cacheRolesInCookie="true"  
      cookieName=".ASPROLES"  
      cookieTimeout="30"  
      cookiePath="/"  
      cookieRequireSSL="true"  
      cookieSlidingExpiration="true"  
      cookieProtection="All" >  
      <providers>  
        <add  
          name="SqlProvider"  
          type="System.Web.Security.SqlRoleProvider"  
          connectionStringName="SqlServices"   
          applicationName="SampleApplication" />  
      </providers>  
    </roleManager>  
  </system.web>  
</configuration>  

Remarques

Cette classe est utilisée par les Roles classes RolePrincipal et pour fournir des services de gestion de rôles pour une application ASP.net à l’aide d’une base de données SQL Server.This class is used by the Roles and RolePrincipal classes to provide role-management services for an ASP.NET application using a SQL Server database. Vous pouvez utiliser la gestion des rôles pour spécifier différents niveaux d’autorisation pour votre application.You can use role management to specify different levels of authorization for your application.

Pour utiliser la SqlRoleProvider classe, vous devez d’abord créer la base de données SQL Server SqlRoleProviderutilisée par le.To use the SqlRoleProvider class, you must first create the SQL Server database used by the SqlRoleProvider. Pour créer la base de données utilisée SqlRoleProvider par la classe, aspnet_regsql.exe exécutez le fichier exécutable situé dans versionNumber le dossier C:\Windows\Microsoft.NET\Framework\ et -Ar spécifiez l’option ( aspnet_regsql.exe -Arpar exemple,).To create the database used by the SqlRoleProvider class, run the aspnet_regsql.exe executable found in the C:\WINDOWS\Microsoft.NET\Framework\ versionNumber folder and specify the -Ar option (for example, aspnet_regsql.exe -Ar). La base de données créée est appelée aspnetdb.The database created is called Aspnetdb. Vous pouvez également exécuter Aspnet_regsql. exe pour extraire le mode de configuration de l’interface graphique utilisateur et choisir de configurer toutes les fonctionnalités de ASP.NET.Alternatively, run aspnet_regsql.exe to pull up the GUI configuration mode and choose to configure all ASP.NET features.

Si le fournisseur de rôle est configuré avec une chaîne de connexion qui utilise la sécurité intégrée, le compte de processus de l’application ASP.NET doit disposer des droits pour se connecter à la base de données SQL Server.If the role provider is configured with a connection string that uses integrated security, the process account of the ASP.NET application must have rights to connect to the SQL Server database.

Le fichier machine. config est configuré avec une SqlRoleProvider instance nommée AspNetSqlProvider qui se connecte au SQL Server sur l’ordinateur local.The Machine.config file is configured with a SqlRoleProvider instance named AspNetSqlProvider that connects to the SQL Server on the local machine. Vous pouvez utiliser cette instance du fournisseur ou spécifier les vôtres dans le fichier Web. config de votre application ASP.NET.You can use this instance of the provider, or specify your own in the Web.config file for your ASP.NET application. Pour utiliser l’instance AspNetSqlProvider, spécifiez AspNetSqlProvider comme defaultProvider dans votre configuration.To use the AspNetSqlProvider instance, specify AspNetSqlProvider as the defaultProvider in your configuration.

Vous pouvez configurer SqlRoleProvider pour utiliser la même base de données et les mêmes informations SqlMembershipProvider utilisateur que pour utiliser une base de données unique pour les informations d’authentification et d’autorisation.You can configure the SqlRoleProvider to use the same database and user information as the SqlMembershipProvider in order to use a single database for authentication and authorization information. Pour utiliser la même base de données pour les informations d’appartenance et de rôle, exécutez le fichier exécutable Aspnet_regsql. exe et installez la fonctionnalité d’appartenance.To use the same database for membership and role information, run the aspnet_regsql.exe executable and install the membership feature. Ensuite, spécifiez la même chaîne de connexion dans votre configuration pour SqlRoleProvider vos SqlMembershipProvider instances et.Then, specify the same connection string in your configuration for both your SqlRoleProvider and SqlMembershipProvider instances. Assurez-vous également que les deux instances de fournisseur ApplicationNamesont configurées avec le même.Also ensure that both provider instances are configured with the same ApplicationName.

Constructeurs

SqlRoleProvider()

Crée une instance de la classe SqlRoleProvider.Creates an instance of the SqlRoleProvider class.

Propriétés

ApplicationName

Obtient ou définit le nom de l'application pour laquelle stocker ou récupérer des informations de rôle.Gets or sets the name of the application for which to store and retrieve role information.

Description

Obtient une description brève et conviviale qui peut s'afficher dans les outils d'administration ou d'autres interfaces utilisateur.Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Hérité de ProviderBase)
Name

Obtient le nom convivial qui référence le fournisseur au cours de la configuration.Gets the friendly name used to refer to the provider during configuration.

(Hérité de ProviderBase)

Méthodes

AddUsersToRoles(String[], String[])

Ajoute le nom des utilisateurs spécifiés à chacun des rôles spécifiés.Adds the specified user names to each of the specified roles.

CreateRole(String)

Ajoute un nouveau rôle à la base de données des rôles.Adds a new role to the role database.

DeleteRole(String, Boolean)

Supprime un rôle de la base de données.Removes a role from the role database.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
FindUsersInRole(String, String)

Obtient un tableau des noms d'utilisateurs figurant dans un rôle, dans lequel le nom d'utilisateur contient le nom d'utilisateur spécifié correspondant.Gets an array of user names in a role where the user name contains the specified user name to match.

GetAllRoles()

Obtient la liste de tous les rôles pour l'application.Gets a list of all the roles for the application.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetRolesForUser(String)

Obtient une liste des rôles dans lesquels figure l'utilisateur.Gets a list of the roles that a user is in.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
GetUsersInRole(String)

Obtient une liste des utilisateurs du rôle spécifié.Gets a list of users in the specified role.

Initialize(String, NameValueCollection)

Initialise le fournisseur de rôles SQL Server à l'aide des valeurs de propriété spécifiées dans le fichier de configuration de l'application ASP.NET.Initializes the SQL Server role provider with the property values specified in the ASP.NET application's configuration file. Cette méthode n'est pas destinée à être utilisée directement depuis votre code.This method is not intended to be used directly from your code.

IsUserInRole(String, String)

Obtient une valeur indiquant si l'utilisateur spécifié figure dans le rôle spécifié.Gets a value indicating whether the specified user is in the specified role.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
RemoveUsersFromRoles(String[], String[])

Supprime les noms d'utilisateurs spécifiés des rôles spécifiés.Removes the specified user names from the specified roles.

RoleExists(String)

Obtient une valeur qui indique si le nom de rôle spécifié existe déjà dans la base de données des rôles.Gets a value indicating whether the specified role name already exists in the role database.

ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi