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


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

Обновлен: Ноябрь 2007

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

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

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

<clear/>

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

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

Атрибуты

Отсутствуют.

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

Отсутствуют.

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

Элемент

Описание

configuration

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

system.web

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

roleManager

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

providers

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

Заметки

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

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

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

Пример

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

<configuration>
  <system.web>
      <roleManager defaultProvider="SqlProvider" 
                   enabled="true"
                   cacheRolesInCookie="true"
                   cookieName=".ASPROLES"
                   cookieTimeout="30"
                   cookiePath="/"
                   cookieRequireSSL="false"
                   cookieSlidingExpiration="true"
                   cookieProtection="All" >
        <providers>
        <clear />
          <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 уровня приложения

Требования

Службы Microsoft IIS версии 5.0, 5.1 или 6.0

Платформа .NET Framework версии 2.0

Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Задачи

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

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

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

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

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

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

Ссылки

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

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

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

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

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

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

System.Configuration

System.Web.Configuration

RoleManagerSection

RoleManager

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

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

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

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

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

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