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

Статья
08/11/2011

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

Этот элемент не использовался до .NET Framework версии 2.0.

<add name="provider name" 
     type="string"
     connectionStringName="string"
     applicationName="string" 
     commandTimeout="number" 
     description="string" 
     cacheRefreshInterval="number" 
     scopeName="string"/>

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

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

Атрибуты

Атрибут	Описание
applicationName	Необязательный атрибут элемента String. Задает имя приложения, в котором реализуется хранение имен ролей в источнике данных. Имя приложения позволяет нескольким приложениям ASP.NET использовать одну базу данных без создания повторяющихся имен ролей для разных приложений. Либо несколько приложений ASP.NET могут использовать одни и те же сведения о ролях. Для этого нужно указать одно имя приложения. Если данный атрибут не указан, то в поставщиках ролей, включенных в .NET Framework, для свойства ApplicationName использует значение ApplicationVirtualPath.
cacheRefreshInterval	Необязательный атрибут типа Int32. Задает время в минутах между принудительными обновлениями кэшированных данных хранилища политик и применим только для AuthorizationStoreRoleProvider. Значение по умолчанию — 60.
commandTimeout	Необязательный атрибут типа Int32. Указывает время в секундах, после которого истекает срок жизни команды, размещенной в источнике данных диспетчера ролей. Это время ожидания используется поставщиком SQL при создании объектов SqlCommand. По умолчанию этот атрибут не задается в конфигурации ASP.NET. В результате используется значение ADO.NET по умолчанию, равное 30 секундам. Если этот атрибут задан, поставщик SQL использует настроенное значение времени ожидания для всех команд SQL, запущенных в базе данных. Значение по умолчанию — 30 (значение по умолчанию ADO.NET).
connectionStringName	Обязательный атрибут типа String. Задает имя строки подключения, определенной в элементе <connectionStrings>. Указанная строка подключения будет использоваться добавляемым поставщиком.
description	Необязательный атрибут типа String. Задает описание экземпляра поставщика ролей.
name	Обязательный атрибут типа String. Задает имя экземпляра поставщика. Это значение, используемое для атрибута defaultProvider элемента <roleManager>, которое определяет экземпляр поставщика ролей по умолчанию. Имя name поставщика также используется для индексации поставщиков в коллекции Providers.
scopeName	Необязательный атрибут типа String. Задает область безопасности хранилища политик диспетчера авторизации, к которому должен подключиться экземпляр поставщика, и применяет только для AuthorizationStoreRoleProvider. Если задан атрибут scopeName, при подключении к хранилищу политик поставщик использует сочетание applicationName и scopeName.
type	Обязательный атрибут типа String. Задает тип, реализующий абстрактный базовый класс RoleProvider.

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

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

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

Элемент	Описание
configuration	Задает обязательный корневой элемент любого файла конфигурации, который используется средой CLR и приложениями .NET Framework.
system.web	Задает корневой элемент для раздела конфигурации ASP.NET.
roleManager	Настраивает приложение для управления ролями.
providers	Определяет коллекцию поставщиков ролей для управления ролями.

Заметки

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

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

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

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

Следующий элемент по умолчанию providers настраивается в файле Machine.config.

<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
Элемент конфигурации	Add
Настраиваемые расположения	Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения
Требования	Microsoft IIS версии 5.0, 5.1 или 6.0 .NET Framework версии 2.0 Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Поделиться через

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

Ссылки

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

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

Дополнительные ресурсы