RoleProvider Класс

Ссылка

Определение

Пространство имен:: System.Web.Security

Сборка:: System.Web.dll

Сборка:: System.Web.ApplicationServices.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public ref class RoleProvider abstract : System::Configuration::Provider::ProviderBase

public abstract class RoleProvider : System.Configuration.Provider.ProviderBase

type RoleProvider = class
    inherit ProviderBase

Public MustInherit Class RoleProvider
Inherits ProviderBase

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

ProviderBase
RoleProvider

Производный: System.Web.ClientServices.Providers.ClientRoleProvider

System.Web.Security.AuthorizationStoreRoleProvider

System.Web.Security.SqlRoleProvider

System.Web.Security.WindowsTokenRoleProvider

ASP.NET управление ролями позволяет легко использовать ряд различных поставщиков ролей для приложений ASP.NET. Можно использовать предоставленные поставщики ролей, включенные в платформа .NET Framework, или реализовать собственный поставщик.

При реализации настраиваемого поставщика ролей необходимо наследовать RoleProvider абстрактный класс.

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

Необходимо хранить сведения о роли в источнике данных, который не поддерживается поставщиками ролей, включенными в платформа .NET Framework, например в базе данных FoxPro, базе данных Oracle или других источниках данных.
Для управления сведениями о роли необходимо использовать схему базы данных, отличную от схемы базы данных, используемой поставщиками, поставляемыми с платформа .NET Framework. Типичным примером этого могут быть данные роли, которые уже существуют в базе данных SQL Server для компании или веб-сайта.

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

RoleProvider()

Инициализирует новый экземпляр класса RoleProvider.

Свойства

ApplicationName	Возвращает или задает имя приложения, для которого будут сохраняться и извлекаться сведения о роли.
Description	Возвращает краткое, понятное описание, подходящее для отображения в инструментах администрирования или других пользовательских интерфейсах (UI). (Унаследовано от ProviderBase)
Name	Возвращает понятное имя, используемое для ссылки на поставщика во время конфигурирования. (Унаследовано от ProviderBase)

Методы

AddUsersToRoles(String[], String[])	Добавляет указанные имена пользователей в указанные роли для настроенного `applicationName`.
CreateRole(String)	Добавляет новую роль к источнику данных для настроенного приложения `applicationName`.
DeleteRole(String, Boolean)	Удаляет роль из источника данных для настроенного `applicationName`.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FindUsersInRole(String, String)	Получает массив имен пользователей в роли, соответствующих указанному имени пользователя.
GetAllRoles()	Получает список всех ролей для настроенного приложения `applicationName`.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetRolesForUser(String)	Возвращает список ролей, в которые добавлен указанный пользователь для настроенного приложения `applicationName`.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
GetUsersInRole(String)	Получает список пользователей в указанной роли для настроенного `applicationName`.
Initialize(String, NameValueCollection)	Инициализирует построитель конфигураций. (Унаследовано от ProviderBase)
IsUserInRole(String, String)	Получает значение, позволяющее определить, может ли заданный пользователь выполнять указанную роль для настроенного `applicationName`.
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
RemoveUsersFromRoles(String[], String[])	Удаляет указанные имена пользователей из указанных ролей для настроенного приложения `applicationName`.
RoleExists(String)	Получает значение, показывающее, существует ли заданное имя роли в источнике данных роли для настроенного `applicationName`.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

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

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

Реализация поставщика ролей