閱讀英文

共用方式為

RoleProvider 類別

  • 參考

定義

命名空間:
System.Web.Security
組件:
System.Web.dll
組件:
System.Web.ApplicationServices.dll

定義 ASP.NET 為使用自訂角色提供者提供角色管理服務所履行的合約。

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

另請參閱