Roles.CacheRolesInCookie 屬性

定義

命名空間:

System.Web.Security

組件:

System.Web.dll

取得值，指出目前使用者的角色是否在 Cookie 中快取。

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

public static bool CacheRolesInCookie { get; }

static member CacheRolesInCookie : bool

Public Shared ReadOnly Property CacheRolesInCookie As Boolean

屬性值

Boolean

如果目前使用者的角色在 Cookie 中快取，則為 true，否則為 false。 預設為 true。

範例

下列範例顯示 ASP.NET 應用程式之 Web.config 檔案區段中 的 roleManager 元素 system.web 。 它會指定應用程式使用 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>

備註

CacheRolesInCookie當 屬性設定 true 為 Web.config 檔案中時，每個使用者的角色資訊會儲存在 Cookie 中。 當角色管理檢查使用者是否處於特定角色時，會在呼叫角色提供者之前檢查角色 Cookie，以檢查資料來源的角色清單。 系統會動態更新 Cookie，以快取最近驗證的角色名稱。

您可以在設定 ASP.NET 角色時指定 CookieProtectionValue 屬性，以改善 Cookie 中快取的角色名稱可靠性。 預設值 CookieProtectionValue 為 All ，它會加密 Cookie 中的角色名稱，並驗證 Cookie 內容尚未變更。

注意

由於角色名稱可以與資料來源分開快取，因此資料來源的角色管理變更可能不會反映在快取的值中。 在此情況下，使用者必須關閉並重新開啟瀏覽器，才能清除快取的 Cookie 值。

另請參閱

• 瞭解角色管理 ASP.NET