RoleServiceManager 類別

定義

命名空間:

System.Web.UI

組件:

System.Web.Extensions.dll

設定角色服務之自訂實作的位置。

public ref class RoleServiceManager

[System.ComponentModel.TypeConverter(typeof(System.Web.UI.EmptyStringExpandableObjectConverter))]
public class RoleServiceManager

[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.EmptyStringExpandableObjectConverter))>]
type RoleServiceManager = class

Public Class RoleServiceManager

繼承

Object

RoleServiceManager

屬性

TypeConverterAttribute

備註

類別RoleServiceManager會對應至 RoleService 或 ScriptManagerProxy 控件的 ScriptManager 屬性。

已啟用 AJAX 的應用程式會使用角色 Web 服務，以使用異步 Web 服務呼叫來擷取目前已驗證使用者的角色資訊。 您可以使用 RoleServiceManager 來提供角色 Web 服務的替代實作路徑，而不是使用內建 Web 服務。

若要在應用程式中使用角色服務，您必須在組態檔中啟用它，並在頁面中宣告它。 如果您使用內建角色 Web 服務，則必須加以啟用，但不需要在頁面中明確宣告角色服務管理員。

若要建立自定義角色服務，您必須實作具有兩種方法的 Web 服務： GetRolesForCurrentUser 和 IsCurrentUserInRole。 這些方法必須具有與內建角色 Web 服務對應方法相同的簽章。

下列範例顯示必須在自定義角色 Web 服務類別中實作的基本類別結構。

若要使用自定義角色 Web 服務，您可以將 元素ScriptManager放在 RoleService 控件內，以宣告方式在標記中新增服務，如下列範例所示。

<asp:ScriptManager ID="SM1" runat="server">  
  <RoleService Path="MyRoleService.asmx" LoadRoles="true" />  
</asp:ScriptManager>  

您也可以以程式設計方式將 Path 屬性設定為使用自定義角色 Web 服務。

建構函式

RoleServiceManager()

初始化 RoleServiceManager 類別的新執行個體。

屬性

LoadRoles	取得或設定值，指出目前登入使用者之角色的清單是否必須擷取。
Path	取得或設定角色服務的路徑。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• ScriptingRoleServiceSection
• ASP.NET AJAX 中的 Web 服務
• 搭配 ASP.NET AJAX 使用角色資訊