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、or ScriptManagerProxy コントロールのRoleServiceプロパティにScriptManager対応します。

ロール Web サービスは、非同期 Web サービス呼び出しを使用して、現在の認証済みユーザーのロール情報を取得するために AJAX 対応アプリケーションによって使用されます。 組み込みの Web サービスを使用する代わりに、ロール Web サービスの代替実装のパスを指定するために使用 RoleServiceManager できます。

アプリケーションでロール サービスを使用するには、構成ファイルでロール サービスを有効にし、ページで宣言する必要があります。 組み込みのロール Web サービスを使用する場合は有効にする必要がありますが、ページでロール サービス マネージャーを明示的に宣言する必要はありません。

カスタム ロール サービスを作成するには、次の 2 つのメソッドを持つ Web サービスを実装する GetRolesForCurrentUser IsCurrentUserInRole必要があります。 これらのメソッドには、組み込みロール Web サービスの対応するメソッドと同じシグネチャが必要です。

次の例は、カスタム ロール Web サービス クラスに実装する必要がある基本的なクラス構造を示しています。

カスタム ロール Web サービスを使用するには、次の例に示すように、コントロール内ScriptManagerに要素をRoleService配置することで、マークアップに宣言によってサービスを追加できます。

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

カスタム ロール Web サービスを使用するようにプロパティを Path プログラムで設定することもできます。

コンストラクター

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 でのロール情報の使用