RoleService 類別

定義

命名空間:

System.Web.ApplicationServices

組件:

System.Web.Extensions.dll

允許以 WCF Web 服務存取 ASP.NET 角色提供者。

public ref class RoleService

[System.ServiceModel.Activation.AspNetCompatibilityRequirements(RequirementsMode=System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required)]
[System.ServiceModel.ServiceBehavior(ConcurrencyMode=System.ServiceModel.ConcurrencyMode.Multiple, InstanceContextMode=System.ServiceModel.InstanceContextMode.Single, Namespace="http://asp.net/ApplicationServices/v200")]
[System.ServiceModel.ServiceContract(Namespace="http://asp.net/ApplicationServices/v200")]
public class RoleService

[<System.ServiceModel.Activation.AspNetCompatibilityRequirements(RequirementsMode=System.ServiceModel.Activation.AspNetCompatibilityRequirementsMode.Required)>]
[<System.ServiceModel.ServiceBehavior(ConcurrencyMode=System.ServiceModel.ConcurrencyMode.Multiple, InstanceContextMode=System.ServiceModel.InstanceContextMode.Single, Namespace="http://asp.net/ApplicationServices/v200")>]
[<System.ServiceModel.ServiceContract(Namespace="http://asp.net/ApplicationServices/v200")>]
type RoleService = class

Public Class RoleService

繼承

Object

RoleService

屬性

AspNetCompatibilityRequirementsAttribute ServiceBehaviorAttribute ServiceContractAttribute

備註

物件 RoleService 可讓您透過 Windows Communication Foundation (WCF) 服務讀取使用者的角色。 若要使用角色服務，您必須在 Web 服務器上啟用角色服務，然後將 WCF 相容的用戶端應用程式連線至 Web 服務。 如需如何設定角色服務的資訊，請參閱 如何：啟用 WCF 角色服務。

使用者必須經過驗證，才能讀取使用者的角色。 角色服務可與任何類型的 ASP.NET 驗證搭配使用。 如需如何透過 WCF 服務登入使用者的詳細資訊，請參閱 Windows Communication Foundation 驗證服務概觀。

類別 RoleService 會公開兩個只能透過 WCF 服務存取的方法： GetRolesForCurrentUser 方法和 IsCurrentUserInRole 方法。 方法 GetRolesForCurrentUser 會傳回已登入使用者的所有角色。 方法 IsCurrentUserInRole 會判斷使用者是否處於指定的角色。

物件 RoleService 會 SelectingProvider 引發 事件。 您可以建立事件的事件處理常式， SelectingProvider 以選取執行時間要使用的角色提供者。

如需如何從主控台應用程式使用 WCF 角色服務的範例，請參閱逐步解說 ：使用 ASP.NET 應用程式服務。

建構函式

RoleService()

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

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetRolesForCurrentUser()	傳回已登入使用者的所有角色。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
IsCurrentUserInRole(String)	判斷登入的使用者是否屬於指定的角色。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

SelectingProvider

當 RoleService 執行個體決定用來檢查使用者角色的角色提供者時發生。

另請參閱

• Windows Communication Foundation 角色服務概觀