RoleManagerSection.CacheRolesInCookie プロパティ

.NET Framework クラス ライブラリ リファレンス

RoleManagerSection.CacheRolesInCookie プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

現在のユーザーのロールが Cookie にキャッシュされているかどうかを示す値を取得または設定します。

名前空間: System.Web.Configuration
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property CacheRolesInCookie As
 Boolean

Visual Basic (使用法)

Dim instance As RoleManagerSection
Dim value As Boolean

value = instance.CacheRolesInCookie

instance.CacheRolesInCookie = value

C#

public bool CacheRolesInCookie { get;
 set; }

C++

public:
property bool CacheRolesInCookie {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_CacheRolesInCookie ()

/** @property */
public void set_CacheRolesInCookie (boolean
 value)

JScript

public function get CacheRolesInCookie
 () : boolean

public function set CacheRolesInCookie
 (value : boolean)

プロパティ値
現在のユーザーのロールが Cookie にキャッシュされている場合は true。それ以外の場合は false。既定値は false です。

解説

CacheRolesInCookie プロパティは、ロール名の Cookie 保存が有効かどうかを示すブール値を返します。

構成ファイルで CacheRolesInCookie プロパティが true に設定されている場合、各ユーザーのロール情報は、クライアント上の Cookie に格納されます。ロール管理でユーザーが特定のロールに設定されているかどうかを確認するときには、ロール プロバイダを呼び出してデータ ソースにあるロールの一覧をチェックする前に、ロールの Cookie がチェックされます。この Cookie はクライアント上で動的に更新され、最新の検証済みロール名をキャッシュします。

構成ファイルの roleManager セクションを設定するときに、CookieProtection プロパティを指定することで、Cookie にキャッシュされるロール名の信頼性を向上できます。CookieProtection プロパティの既定値は All です。これは、Cookie 内のロール名を暗号化し、Cookie の内容が改ざんされていないかどうかを検査します。

使用例

CacheRolesInCookie プロパティを使用する方法を次のコード例に示します。このコード例は、RoleManagerSection クラスのトピックで取り上げているコード例の一部分です。

Visual Basic

' Display CacheRolesInCookie property.
Console.WriteLine("CacheRolesInCookie: {0}", _
 configSection.CacheRolesInCookie)

C#

// Display CacheRolesInCookie property.
Console.WriteLine("CacheRolesInCookie: {0}",
  configSection.CacheRolesInCookie);

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
RoleManagerSection クラス
RoleManagerSection メンバ
System.Web.Configuration 名前空間