SqlRoleProvider Klass

Definition

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

Arv

Object

ProviderBase

RoleProvider

SqlRoleProvider

Exempel

I följande exempel visas Web.config-filen för ett ASP.NET-program som har konfigurerats för att använda ett SqlRoleProvider-objekt och SqlMembershipProvider. Elementet authorization är konfigurerat för att endast tillåta åtkomst till autentiserade användare i rollen Administratörer.

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

Kommentarer

Den här klassen används av klasserna Roles och RolePrincipal för att tillhandahålla rollhanteringstjänster för ett ASP.NET program med hjälp av en SQL Server databas. Du kan använda rollhantering för att ange olika auktoriseringsnivåer för ditt program.

Om du vill använda klassen SqlRoleProvider måste du först skapa den SQL Server databas som används av SqlRoleProvider. Om du vill skapa databasen som används av klassen SqlRoleProvider kör du aspnet_regsql.exe körbar fil i mappen C:\WINDOWS\Microsoft.NET\Framework\ versionNumber och anger alternativet -Ar (till exempel aspnet_regsql.exe -Ar). Databasen som skapas kallas Aspnetdb. Du kan också köra aspnet_regsql.exe för att hämta GUI-konfigurationsläget och välja att konfigurera alla ASP.NET funktioner.

Om rollprovidern har konfigurerats med en reťazec pripojenia som använder integrerad säkerhet måste processkontot för ASP.NET-programmet ha behörighet att ansluta till SQL Server-databasen.

Filen Machine.config har konfigurerats med en SqlRoleProvider-instans med namnet AspNetSqlProvider som ansluter till SQL Server på den lokala datorn. Du kan använda den här instansen av providern eller ange din egen i Web.config-filen för ditt ASP.NET-program. Om du vill använda AspNetSqlProvider-instansen anger du AspNetSqlProvider som i konfigurationen defaultProvider .

Du kan konfigurera SqlRoleProvider att använda samma databas och användarinformation som SqlMembershipProvider för att använda en enkel databas för autentiserings- och auktoriseringsinformation. Om du vill använda samma databas för medlemskaps- och rollinformation kör du aspnet_regsql.exe körbar fil och installerar medlemskapsfunktionen. Ange sedan samma reťazec pripojenia i konfigurationen för både instanserna SqlRoleProvider och SqlMembershipProvider. Kontrollera också att båda providerinstanserna är konfigurerade med samma ApplicationName.

Se även

• Förstå ASP.NET rollhantering