RoleProvider Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет контракт, который реализуется ASP.NET, чтобы предоставлять службы управления ролями, используя пользовательские поставщики ролей.
public ref class RoleProvider abstract : System::Configuration::Provider::ProviderBasepublic abstract class RoleProvider : System.Configuration.Provider.ProviderBasetype RoleProvider = class
inherit ProviderBasePublic MustInherit Class RoleProvider
Inherits ProviderBase- Наследование
- Производный
Комментарии
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[]) |
Добавляет указанные имена пользователей в указанные роли для настроенного |
| CreateRole(String) |
Добавляет новую роль к источнику данных для настроенного приложения |
| DeleteRole(String, Boolean) |
Удаляет роль из источника данных для настроенного |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FindUsersInRole(String, String) |
Получает массив имен пользователей в роли, соответствующих указанному имени пользователя. |
| GetAllRoles() |
Получает список всех ролей для настроенного приложения |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetRolesForUser(String) |
Возвращает список ролей, в которые добавлен указанный пользователь для настроенного приложения |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| GetUsersInRole(String) |
Получает список пользователей в указанной роли для настроенного |
| Initialize(String, NameValueCollection) |
Инициализирует построитель конфигураций. (Унаследовано от ProviderBase) |
| IsUserInRole(String, String) |
Получает значение, позволяющее определить, может ли заданный пользователь выполнять указанную роль для настроенного |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| RemoveUsersFromRoles(String[], String[]) |
Удаляет указанные имена пользователей из указанных ролей для настроенного приложения |
| RoleExists(String) |
Получает значение, показывающее, существует ли заданное имя роли в источнике данных роли для настроенного |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
