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

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

Esta clase es utilizada por el Roles y RolePrincipal clases para proporcionar servicios de administración de roles para una aplicación 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 Administración de roles para especificar distintos niveles de autorización para la aplicación.You can use role management to specify different levels of authorization for your application.

Para usar el SqlRoleProvider (clase), primero debe crear la base de datos de SQL Server utilizado por el SqlRoleProvider.To use the SqlRoleProvider class, you must first create the SQL Server database used by the SqlRoleProvider. Para crear la base de datos utilizado por el SqlRoleProvider (clase), ejecute el aspnet_regsql.exe ejecutable se encuentra en la C:\WINDOWS\Microsoft.NET\Framework\ versionNumber carpeta y especifique la -Ar opción (por ejemplo, aspnet_regsql.exe -Ar).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 creado se denomina Aspnetdb.The database created is called Aspnetdb. Como alternativa, ejecute aspnet_regsql.exe para extraer el modo de configuración de la interfaz gráfica de usuario y elija Configurar todas las características 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 utiliza 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 un SqlRoleProvider instancia denominada AspNetSqlProvider que se conecta a 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 su propia en el archivo Web.config para la aplicación de 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 el defaultProvider en la configuración.To use the AspNetSqlProvider instance, specify AspNetSqlProvider as the defaultProvider in your configuration.

Puede configurar el SqlRoleProvider para usar la misma información de usuario y la base de datos que el SqlMembershipProvider para poder usar una sola base de datos para obtener 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 suscripción y la información de la función, ejecute el archivo 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 tanto para su SqlRoleProvider y SqlMembershipProvider instancias.Then, specify the same connection string in your configuration for both your SqlRoleProvider and SqlMembershipProvider instances. También garantiza que ambas instancias del proveedor estén configurados 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 los nombres de usuario de un rol que contengan un nombre de usuario determinado que debe coincidir.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: