RoleProvider Класс

Определение

Определяет контракт, который реализуется ASP.NET, чтобы предоставлять управление ролью, используя пользовательские поставщики роли.Defines the contract that ASP.NET implements to provide role-management services using custom role providers.

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
Наследование
RoleProvider
Производный

Комментарии

Управление ролями ASP.NET предназначено для того, чтобы вы могли легко использовать несколько различных поставщиков ролей для приложений ASP.NET.ASP.NET role management is designed to enable you to easily use a number of different role providers for your ASP.NET applications. Вы можете использовать указанные поставщики ролей, входящие в состав .NET Framework, или реализовать собственный поставщик.You can use the supplied role providers that are included with the .NET Framework, or you can implement your own provider.

При реализации пользовательского поставщика ролей требуется наследование RoleProvider абстрактного класса.When implementing a custom role provider, you are required to inherit the RoleProvider abstract class.

Существует две основные причины для создания пользовательского поставщика ролей.There are two primary reasons for creating a custom role provider.

  • Сведения о ролях необходимо хранить в источнике данных, который не поддерживается поставщиками ролей, входящими в .NET Framework, например в базу данных FoxPro, базу данных Oracle или другие источники данных.You need to store role information in a data source that is not supported by the role providers included with the .NET Framework, such as a FoxPro database, an Oracle database, or other data sources.

  • Необходимо управлять сведениями о ролях с помощью схемы базы данных, отличной от схемы базы данных, используемой поставщиками, поставляемыми с .NET Framework.You need to manage role information using a database schema that is different from the database schema used by the providers that ship with the .NET Framework. Распространенный пример — данные роли, которые уже существуют в SQL Server базе данных для компании или веб-сайта.A common example of this would be role data that already exists in a SQL Server database for a company or Web site.

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

RoleProvider()

Инициализирует новый экземпляр класса RoleProvider.Initializes a new instance of the RoleProvider class.

Свойства

ApplicationName

Возвращает или задает имя приложения, для которого будут сохраняться и извлекаться сведения о роли.Gets or sets the name of the application to store and retrieve role information for.

Description

Возвращает краткое, понятное описание, подходящее для отображения в инструментах администрирования или других пользовательских интерфейсах (UI).Gets a brief, friendly description suitable for display in administrative tools or other user interfaces (UIs).

(Унаследовано от ProviderBase)
Name

Возвращает понятное имя, используемое для ссылки на поставщика во время конфигурирования.Gets the friendly name used to refer to the provider during configuration.

(Унаследовано от ProviderBase)

Методы

AddUsersToRoles(String[], String[])

Добавляет указанные имена пользователей к указанным ролям для установленного приложения applicationName.Adds the specified user names to the specified roles for the configured applicationName.

CreateRole(String)

Добавляет новую роль к источнику данных для настроенного приложения applicationName.Adds a new role to the data source for the configured applicationName.

DeleteRole(String, Boolean)

Удаляет роль из источника данных для настроенного приложения applicationName.Removes a role from the data source for the configured applicationName.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FindUsersInRole(String, String)

Возвращает массив имен пользователей в роли, у которых имена совпадают с указанными именами пользователей.Gets an array of user names in a role where the user name contains the specified user name to match.

GetAllRoles()

Возвращает список всех ролей для настроенного applicationName.Gets a list of all the roles for the configured applicationName.

GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetRolesForUser(String)

Возвращает список ролей, с которыми связан указанный пользователей для настроенного applicationName.Gets a list of the roles that a specified user is in for the configured applicationName.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetUsersInRole(String)

Возвращает список пользователей, связанных с указанной ролью, для настроенного applicationName.Gets a list of users in the specified role for the configured applicationName.

Initialize(String, NameValueCollection)

Инициализирует построитель конфигураций.Initializes the configuration builder.

(Унаследовано от ProviderBase)
IsUserInRole(String, String)

Возвращает значение, указывающее связан ли указанный пользователь с указанной ролью для настроенного applicationName.Gets a value indicating whether the specified user is in the specified role for the configured applicationName.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
RemoveUsersFromRoles(String[], String[])

Удаляет указанные имена пользователей из указанных ролей для установленного приложения applicationName.Removes the specified user names from the specified roles for the configured applicationName.

RoleExists(String)

Возвращает значение, указывающее, существует ли указанная роль в источнике данных ролей для настроенного applicationName.Gets a value indicating whether the specified role name already exists in the role data source for the configured applicationName.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

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

Дополнительно