使用英语阅读

通过

RoleProvider 类

  • 参考

定义

命名空间:
System.Web.Security
程序集:
System.Web.dll
程序集:
System.Web.ApplicationServices.dll

定义 ASP.NET 为使用自定义角色提供程序提供角色管理服务而实现的协定。

C# 
public abstract class RoleProvider : System.Configuration.Provider.ProviderBase
继承
Object
ProviderBase
RoleProvider
派生

注解

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)

适用于

产品 版本
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

另请参阅