Элемент providers для элемента roleManager (схема параметров ASP.NET)

Определяет коллекцию поставщиков ролей для управления ролями.

<providers>
   <add />
   <clear/>
   <remove />
</providers>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы для данного раздела.

Атрибуты

Отсутствует.

Дочерние элементы

Элемент

Описание

add

Необязательный элемент.

Добавляет экземпляр поставщика ролей в коллекцию поставщиков ролей для управления ролями.

clear

Необязательный элемент.

Удаляет все ссылки на наследуемых поставщиков управления ролями, кроме тех, которые добавлены текущим элементом add.

remove

Необязательный элемент.

Удаляет из коллекции поставщиков ролей ссылку на наследуемого поставщика.

Родительские элементы

Элемент

Описание

configuration

Обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.

system.web

Определяет корневой элемент для раздела конфигурации ASP.NET.

roleManager

Настраивает приложение для управления ролями.

Заметки

Элемент providers определяет коллекцию поставщиков ролей для управления ролями.

Сведения о доступе к данным конфигурации элемента roleManager в коде приложения и об изменении этих данных см. в классе RoleManagerSection, а также в следующих поставщиках ролей WindowsTokenRoleProvider, SqlRoleProvider.

Конфигурация по умолчанию

Следующий используемый по умолчанию элемент element настроен в файле конфигурации компьютера.

<roleManager>
   <providers>
      <add name="AspNetSqlRoleProvider" connectionStringName="LocalSqlServer" applicationName="/" type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
        <add name="AspNetWindowsTokenRoleProvider" applicationName="/" type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" /> 
   </providers>
</roleManager>

Пример

В следующем примере показано приложение ASP.NET, настроенное на использование класса SqlRoleProvider для хранения и извлечения сведений о ролях.

<configuration>
  <system.web>
      <roleManager defaultProvider="SqlProvider" 
                   enabled="true"
                   cacheRolesInCookie="true"
                   cookieName=".ASPROLES"
                   cookieTimeout="30"
                   cookiePath="/"
                   cookieRequireSSL="false"
                   cookieSlidingExpiration="true"
                   cookieProtection="All" >
        <providers>
          <add
            name="SqlProvider"
            type="System.Web.Security.SqlRoleProvider"
            connectionStringName="SqlServices" 
            applicationName="SampleApplication" />
            
        </providers>
      </roleManager>
  </system.web>
</configuration>

Сведения об элементе

Обработчик раздела конфигурации

RoleManagerSection

Элемент конфигурации

Providers

Настраиваемые расположения.

Machine.config

Файл Web.config корневого уровня

Файл Web.config уровня приложения

Требования

IIS версии 5.0, 5.1 или 6.0

Платформа .NET Framework 2.0

Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Ссылки

Элемент roleManager (схема параметров ASP.NET)

Элемент add для элемента providers для элемента roleManager (схема параметров ASP.NET)

Элемент clear для элемента providers для элемента roleManager (схема параметров ASP.NET)

Элемент remove для элемента providers для элемента roleManager (схема параметров ASP.NET)

Элемент system.web (схема параметров ASP.NET)

Элемент configuration (схема общих параметров)

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

Основные понятия

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

Настройка обеспечения безопасности ASP.NET

Сценарии конфигурации ASP.NET

Другие ресурсы

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Справочные сведения о ASP.NET

Администрирование веб-сайта ASP.NET

Конфигурационный API-интерфейс настройки ASP.NET