SqlRoleProvider Classe

Definição

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

Herança

Object

ProviderBase

RoleProvider

SqlRoleProvider

Exemplos

O exemplo a seguir mostra o arquivo Web.config de um aplicativo ASP.NET configurado para usar um objeto SqlRoleProvider e o SqlMembershipProvider. O authorization elemento é configurado para permitir apenas o acesso a usuários autenticados na função Administradores.

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

Comentários

Essa classe é usada pelas classes Roles e RolePrincipal para fornecer serviços de gerenciamento de função para um aplicativo ASP.NET usando um banco de dados SQL Server. Você pode usar o gerenciamento de funções para especificar diferentes níveis de autorização para seu aplicativo.

Para usar a classe SqlRoleProvider, primeiro você deve criar o banco de dados SQL Server usado pelo SqlRoleProvider. Para criar o banco de dados usado pela classe SqlRoleProvider, execute o executável aspnet_regsql.exe encontrado na pasta C:\WINDOWS\Microsoft.NET\Framework\ versionNumber e especifique a opção -Ar (por exemplo, aspnet_regsql.exe -Ar). O banco de dados criado é chamado de Aspnetdb. Como alternativa, execute aspnet_regsql.exe para efetuar pull do modo de configuração de GUI e optar por configurar todos os recursos ASP.NET.

Se o provedor de função estiver configurado com um cadeia de conexão que usa segurança integrada, a conta de processo do aplicativo ASP.NET deverá ter direitos para se conectar ao banco de dados SQL Server.

O arquivo Machine.config é configurado com uma instância de SqlRoleProvider chamada AspNetSqlProvider que se conecta ao SQL Server no computador local. Você pode usar essa instância do provedor ou especificar sua própria no arquivo Web.config para seu aplicativo ASP.NET. Para usar a instância aspNetSqlProvider, especifique AspNetSqlProvider como o defaultProvider da configuração.

Você pode configurar as SqlRoleProvider mesmas informações SqlMembershipProvider de banco de dados e de usuário para usar um banco de dados individual para obter informações de autenticação e autorização. Para usar o mesmo banco de dados para informações de associação e função, execute o aspnet_regsql.exe executável e instale o recurso de associação. Em seguida, especifique o mesmo cadeia de conexão em sua configuração para as instâncias SqlRoleProvider e SqlMembershipProvider. Verifique também se ambas as instâncias de provedor estão configuradas com o mesmo ApplicationName.

Confira também

• Noções básicas sobre ASP.NET Gerenciamento de Funções