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 サービスを介してのみアクセスする必要がある 2 つのメソッド (GetRolesForCurrentUser メソッドと IsCurrentUserInRole メソッド) を公開します。 GetRolesForCurrentUser メソッドは、ログインしているユーザーのすべてのロールを返します。 IsCurrentUserInRole メソッドは、ユーザーが指定されたロールに含まれているかどうかを判断します。

RoleService オブジェクトは、SelectingProvider イベントを発生させます。 SelectingProvider イベントのイベント ハンドラーを作成して、実行時に使用するロール プロバイダーを選択します。

コンソール アプリケーションから WCF ロール サービスを使用する方法の例については、「Walkthrough: using ASP.NET Application Services」を参照してください。

コンストラクター

名前 説明
RoleService()

RoleService クラスの新しいインスタンスを初期化します。

メソッド

名前 説明
Equals(Object)

指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetRolesForCurrentUser()

ログインしているユーザーのすべてのロールを返します。
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
IsCurrentUserInRole(String)

ログインしているユーザーが指定したロールに属しているかどうかを判断します。
MemberwiseClone()

現在の Objectの簡易コピーを作成します。

(継承元 Object)
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

イベント

名前 説明
SelectingProvider

RoleService インスタンスが、ユーザーのロールの確認に使用するロール プロバイダーを決定したときに発生します。

適用対象

こちらもご覧ください