ClientRoleProvider クラス

定義

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

コンストラクター

プロパティ

メソッド

適用対象

こちらもご覧ください

• CurrentPrincipal
• ClientRolePrincipal
• IsInRole(String)
• ServiceUri
• GetRolesForUser(String)
• IsUserInRole(String, String)
• ResetCache()
• クライアント アプリケーション サービスの
• 方法: クライアント アプリケーション サービスの を構成する