SqlRoleProvider Класс

Определение

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

Наследование

Object

ProviderBase

RoleProvider

SqlRoleProvider

Примеры

В следующем примере показан файл Web.config для приложения ASP.NET, настроенного SqlRoleProvider для использования объекта и SqlMembershipProvider. Элемент authorization настроен так, чтобы разрешить доступ только пользователям, прошедшим проверку подлинности, в роли Администраторы.

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

Комментарии

Этот класс используется классами Roles и RolePrincipal для предоставления служб управления ролями для приложения ASP.NET с помощью базы данных SQL Server. Управление ролями можно использовать для указания различных уровней авторизации для приложения.

Чтобы использовать SqlRoleProvider класс , необходимо сначала создать базу данных SQL Server, используемую .SqlRoleProvider Чтобы создать базу данных, используемую классом , запустите aspnet_regsql.exe исполняемый файл, найденный в папке C:\WINDOWS\Microsoft.NET\Framework\versionNumber, и укажите -Ar параметр (например, aspnet_regsql.exe -Ar).SqlRoleProvider Созданная база данных называется Aspnetdb. Кроме того, запустите aspnet_regsql.exe, чтобы перенастроить режим конфигурации графического пользовательского интерфейса и настроить все функции ASP.NET.

Если для поставщика ролей настроена строка подключения, использующая встроенную безопасность, учетная запись процесса приложения ASP.NET должна иметь права на подключение к базе данных SQL Server.

Файл Machine.config настраивается с помощью экземпляра SqlRoleProvider с именем AspNetSqlProvider, который подключается к SQL Server на локальном компьютере. Вы можете использовать этот экземпляр поставщика или указать собственный в файле Web.config для ASP.NET приложения. Чтобы использовать экземпляр AspNetSqlProvider, укажите AspNetSqlProvider в defaultProvider качестве в конфигурации.

Можно настроить SqlRoleProvider для использования той же базы данных и сведений о пользователе, SqlMembershipProvider что и , чтобы использовать одну базу данных для проверки подлинности и авторизации. Чтобы использовать ту же базу данных для сведений о членстве и роли, запустите исполняемый файл aspnet_regsql.exe и установите компонент членства. Затем укажите ту же строку подключения в конфигурации для экземпляров SqlRoleProvider и SqlMembershipProvider . Кроме того, убедитесь, что оба экземпляра поставщика настроены с одинаковым ApplicationName.

Конструкторы

Свойства

Методы

Применяется к

См. также раздел

• Основные сведения об управлении ролями ASP.NET