次の方法で共有

ClientRoleProvider クラス

  • リファレンス

定義

名前空間:
System.Web.ClientServices.Providers
アセンブリ:
System.Web.Extensions.dll

Microsoft Ajax ロール サービスから Windows ベースのアプリケーションのロール情報を取得します。

public ref class ClientRoleProvider : System::Web::Security::RoleProvider
public class ClientRoleProvider : System.Web.Security.RoleProvider
type ClientRoleProvider = class
    inherit RoleProvider
Public Class ClientRoleProvider
Inherits RoleProvider
継承
Object
ProviderBase
RoleProvider
ClientRoleProvider

例

次のコード例は、このプロパティを使用して、プログラムによってロール サービスの場所を設定する方法を示しています。

private void SetRolesServiceLocation()
{
    ((ClientRoleProvider)System.Web.Security.Roles.Provider).ServiceUri = 
        "http://localhost:55555/AppServices/Role_JSON_AppService.axd";
}

Private Sub SetRolesServiceLocation()
    CType(System.Web.Security.Roles.Provider,  _
        ClientRoleProvider).ServiceUri = _
        "http://localhost:55555/AppServices/Role_JSON_AppService.axd"
End Sub

注釈

クライアント アプリケーション サービスを使用して、ClientRoleProvider クラスを使用するようにアプリケーションを構成することで、既存のロール サービスからロール情報を取得できます。 構成後、staticThread.CurrentPrincipal プロパティによって返される IPrincipal の IsInRole メソッドを呼び出すことによって、認証されたユーザーが特定のロールに含まれているかどうかを確認できます。 クライアント アプリケーション サービスを使用するように構成されたアプリケーションの場合、このプロパティは ClientRolePrincipalを返します。 このクラスは IPrincipal インターフェイスを実装するため、明示的に参照する必要はありません。 ClientRolePrincipal.IsInRole メソッドは、ClientRoleProvider.IsUserInRole メソッドを内部的に呼び出します。

ClientRoleProvider クラスは、ServiceUri プロパティによって示されるロール サービスから認証済みユーザーのロール情報を取得する読み取り専用ロール メンバーシップ プロバイダーです。 通常、ServiceUri プロパティの値は、他の構成値と共にアプリケーション構成ファイルから取得されます。

static Roles.Provider プロパティを使用して、現在の ClientRoleProvider インスタンスを取得できます。

ClientRoleProvider クラスは、RoleProvider 抽象クラスの GetRolesForUser メソッドと IsUserInRole メソッドのみをサポートします。 特定のユーザーに対してこれらのメソッドのいずれかを呼び出すと、サービス プロバイダーは最初にローカル データ キャッシュでロール情報を確認します。 キャッシュにロール情報が含まれていないか、キャッシュの有効期限が切れている場合、サービス プロバイダーはロール情報を roles サービスから取得してキャッシュに追加します。

クライアント アプリケーション サービスを構成するときに、ロール キャッシュのタイムアウト期間を指定できます。 GetRolesForUser メソッドがローカル キャッシュではなくサービスからロール データを取得するように強制するには、最初に ResetCache メソッドを呼び出します。

ClientRoleProvider クラスを使用してロールを作成または削除したり、ユーザーのロール メンバーシップを変更したりすることはできません。 ロール情報を作成または変更するには、サーバー上のロール サービスの構成を変更する必要があります。

コンストラクター

ClientRoleProvider()

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

プロパティ

ApplicationName

このプロパティは、このクラスでは使用されません。
Description

管理ツールやその他のユーザー インターフェイス (UI) での表示に適した簡単でわかりやすい説明を取得します。

(継承元 ProviderBase)
Name

構成時にプロバイダーを参照するために使用されるフレンドリ名を取得します。

(継承元 ProviderBase)
ServiceUri

ロール サービスの URI を取得または設定します。

メソッド

AddUsersToRoles(String[], String[])

このメソッドは、このクラスでは使用されません。
CreateRole(String)

このメソッドは、このクラスでは使用されません。
DeleteRole(String, Boolean)

このメソッドは、このクラスでは使用されません。
Equals(Object)

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

(継承元 Object)
FindUsersInRole(String, String)

このメソッドは、このクラスでは使用されません。
GetAllRoles()

このメソッドは、このクラスでは使用されません。
GetHashCode()

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

(継承元 Object)
GetRolesForUser(String)

指定したユーザーが属しているロールの名前を取得します。
GetType()

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

(継承元 Object)
GetUsersInRole(String)

このメソッドは、このクラスでは使用されません。
Initialize(String, NameValueCollection)

プロバイダーを初期化します。
IsUserInRole(String, String)

指定したユーザーが指定したロールに含まれているかどうかを示す値を取得します。
MemberwiseClone()

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

(継承元 Object)
RemoveUsersFromRoles(String[], String[])

このメソッドは、このクラスでは使用されません。
ResetCache()

キャッシュされたロール情報をクリアし、キャッシュタイムアウト期間をリセットします。
RoleExists(String)

このメソッドは、このクラスでは使用されません。
ToString()

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

(継承元 Object)

適用対象

こちらもご覧ください