SqlRoleProvider SqlRoleProvider SqlRoleProvider SqlRoleProvider Class

Definición

Administra el almacenamiento de la información de pertenencia a roles para una aplicación ASP.NET en una base de datos de 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
Herencia

Ejemplos

En el ejemplo siguiente se muestra el archivo Web. config para una aplicación ASP.net configurada para usar SqlMembershipProviderun SqlRoleProvider objeto y.The following example shows the Web.config file for an ASP.NET application configured to use a SqlRoleProvider object and the SqlMembershipProvider. El elemento está configurado para permitir solo el acceso a los usuarios autenticados en el rol administradores.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>  

Comentarios

Las Roles clases y RolePrincipal usan esta clase para proporcionar servicios de administración de roles para una aplicación de ASP.net con una base de datos de 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. Puede usar la administración de roles para especificar diferentes niveles de autorización para la aplicación.You can use role management to specify different levels of authorization for your application.

Para usar la SqlRoleProvider clase, primero debe crear la base de datos SQL Server utilizada SqlRoleProviderpor.To use the SqlRoleProvider class, you must first create the SQL Server database used by the SqlRoleProvider. Para crear la base de datos utilizada SqlRoleProvider por la clase, aspnet_regsql.exe ejecute el archivo ejecutable que se versionNumber encuentra en la carpeta -Ar C:\Windows\Microsoft.NET\Framework\ y especifique la opción aspnet_regsql.exe -Ar(por ejemplo,).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 datos creada se denomina Aspnetdb.The database created is called Aspnetdb. También puede ejecutar aspnet_regsql. exe para extraer el modo de configuración de la GUI y elegir configurar todas las características de ASP.NET.Alternatively, run aspnet_regsql.exe to pull up the GUI configuration mode and choose to configure all ASP.NET features.

Si el proveedor de roles se configura con una cadena de conexión que usa seguridad integrada, la cuenta de proceso de la aplicación ASP.NET debe tener derechos para conectarse a la base de datos de 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.

El archivo Machine. config se configura con una SqlRoleProvider instancia denominada AspNetSqlProvider que se conecta al SQL Server en el equipo local.The Machine.config file is configured with a SqlRoleProvider instance named AspNetSqlProvider that connects to the SQL Server on the local machine. Puede usar esta instancia del proveedor o especificar la suya propia en el archivo Web. config para la aplicación ASP.NET.You can use this instance of the provider, or specify your own in the Web.config file for your ASP.NET application. Para usar la instancia de AspNetSqlProvider, especifique AspNetSqlProvider como defaultProvider en la configuración.To use the AspNetSqlProvider instance, specify AspNetSqlProvider as the defaultProvider in your configuration.

Puede configurar SqlRoleProvider para que utilice la misma base de datos y la misma información SqlMembershipProvider de usuario que para utilizar una base de datos única para la información de autenticación y autorización.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. Para usar la misma base de datos para la información de pertenencia y los roles, ejecute el archivo ejecutable Aspnet_regsql. exe e instale la característica de pertenencia.To use the same database for membership and role information, run the aspnet_regsql.exe executable and install the membership feature. A continuación, especifique la misma cadena de conexión en la configuración de SqlRoleProvider las SqlMembershipProvider instancias de y.Then, specify the same connection string in your configuration for both your SqlRoleProvider and SqlMembershipProvider instances. Asegúrese también de que ambas instancias de proveedor estén configuradas con el mismo ApplicationName.Also ensure that both provider instances are configured with the same ApplicationName.

Constructores

SqlRoleProvider() SqlRoleProvider() SqlRoleProvider() SqlRoleProvider()

Crea una instancia de la clase SqlRoleProvider.Creates an instance of the SqlRoleProvider class.

Propiedades

ApplicationName ApplicationName ApplicationName ApplicationName

Obtiene o establece el nombre de la aplicación para la que se va a almacenar y recuperar información de roles.Gets or sets the name of the application for which to store and retrieve role information.

Description Description Description Description

Obtiene una descripción breve y fácil de comprender apropiada para mostrarla en las herramientas administrativas u otras interfaces de usuario.Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Inherited from ProviderBase)
Name Name Name Name

Obtiene el nombre descriptivo utilizado para hacer referencia al proveedor durante la configuración.Gets the friendly name used to refer to the provider during configuration.

(Inherited from ProviderBase)

Métodos

AddUsersToRoles(String[], String[]) AddUsersToRoles(String[], String[]) AddUsersToRoles(String[], String[]) AddUsersToRoles(String[], String[])

Agrega los nombres de usuario especificados a cada una de los roles especificados.Adds the specified user names to each of the specified roles.

CreateRole(String) CreateRole(String) CreateRole(String) CreateRole(String)

Agrega una nuevo rol a la base de datos de roles.Adds a new role to the role database.

DeleteRole(String, Boolean) DeleteRole(String, Boolean) DeleteRole(String, Boolean) DeleteRole(String, Boolean)

Quita un rol de la base de datos de roles.Removes a role from the role database.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindUsersInRole(String, String) FindUsersInRole(String, String) FindUsersInRole(String, String) FindUsersInRole(String, String)

Obtiene una matriz de nombres de usuario en un rol donde el nombre de usuario contiene el nombre de usuario especificado para la búsqueda.Gets an array of user names in a role where the user name contains the specified user name to match.

GetAllRoles() GetAllRoles() GetAllRoles() GetAllRoles()

Obtiene una lista de todas los roles de la aplicación.Gets a list of all the roles for the application.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetRolesForUser(String) GetRolesForUser(String) GetRolesForUser(String) GetRolesForUser(String)

Obtiene una lista de los roles en que está incluido un usuario.Gets a list of the roles that a user is in.

GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetUsersInRole(String) GetUsersInRole(String) GetUsersInRole(String) GetUsersInRole(String)

Obtiene una lista de usuarios incluidos en el rol especificado.Gets a list of users in the specified role.

Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection) Initialize(String, NameValueCollection)

Inicializa el proveedor de roles de SQL Server con los valores de propiedades especificados en el archivo de configuración de la aplicación ASP.NET.Initializes the SQL Server role provider with the property values specified in the ASP.NET application's configuration file. Este método no está pensado para usarse directamente desde su código.This method is not intended to be used directly from your code.

IsUserInRole(String, String) IsUserInRole(String, String) IsUserInRole(String, String) IsUserInRole(String, String)

Obtiene un valor que indica si el usuario especificado está incluido en el rol especificado.Gets a value indicating whether the specified user is in the specified role.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveUsersFromRoles(String[], String[]) RemoveUsersFromRoles(String[], String[]) RemoveUsersFromRoles(String[], String[]) RemoveUsersFromRoles(String[], String[])

Quita los nombres de usuario especificados de los roles especificados.Removes the specified user names from the specified roles.

RoleExists(String) RoleExists(String) RoleExists(String) RoleExists(String)

Obtiene un valor que indica si el nombre del rol especificado ya existe en la base de datos de roles.Gets a value indicating whether the specified role name already exists in the role database.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: