Roles.CacheRolesInCookie プロパティ

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

Roles.CacheRolesInCookie プロパティ

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

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

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

Visual Basic (宣言)

Public Shared ReadOnly Property
 CacheRolesInCookie As Boolean

Visual Basic (使用法)

Dim value As Boolean

value = Roles.CacheRolesInCookie

C#

public static bool CacheRolesInCookie
 { get; }

C++

public:
static property bool CacheRolesInCookie {
    bool get ();
}

J#

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

JScript

public static function get
 CacheRolesInCookie () : boolean

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

解説

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

ASP.NET ロールを構成する際に CookieProtectionValue プロパティを指定すると、Cookie にキャッシュされるロール名の信頼性が向上します。CookieProtectionValue の既定値は All です。これは、Cookie 内のロール名を暗号化し、Cookie の内容が改ざんされていないかどうかを検査します。

メモ
ロール名はデータ ソースとは別にキャッシュできるので、データ ソースのロール管理への変更が、キャッシュされた値に反映されないこともあります。そのような場合、ユーザーはブラウザを一度閉じてから再び開いて、キャッシュされた Cookie 値をクリアする必要があります。

使用例

ASP.NET アプリケーションの Web.config ファイルの system.web セクションの roleManager 要素の例を次に示します。この例では、アプリケーションが SqlRoleProvider インスタンスを使用することを指定し、cacheRolesInCookie 属性を true に設定します。

<roleManager defaultProvider="SqlProvider" 
  enabled="true"
  cacheRolesInCookie="true"
  cookieName=".ASPROLES"
  cookieTimeout="30"
  cookiePath="/"
  cookieRequireSSL="false"
  cookieSlidingExpiration="true"
  cookieProtection="All" >
  <providers>
    <add
      name="SqlProvider"
      type="System.Web.Security.SqlRoleProvider"
      connectionStringName="SqlServices"
      applicationName="MyApplication" />
   </providers>
</roleManager>

プラットフォーム

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

参照

関連項目
Roles クラス
Roles メンバ
System.Web.Security 名前空間
その他の技術情報
ロール管理について