RoleServiceManager 類別

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

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

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

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

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

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

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

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

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

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

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

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