This documentation is archived and is not being maintained.

Roles.CacheRolesInCookie Property

Gets a value indicating whether the current user's roles are cached in a cookie.

Namespace: System.Web.Security
Assembly: System.Web (in system.web.dll)

static property bool CacheRolesInCookie {
	bool get ();
/** @property */
public static boolean get_CacheRolesInCookie ()

public static function get CacheRolesInCookie () : boolean

Not applicable.

Property Value

true if the current user's roles are cached in a cookie; otherwise, false. The default is true.

When the CacheRolesInCookie property is set to true in the Web.config file, role information for each user is stored in a cookie. When role management checks to see whether a user is in a particular role, the roles cookie is checked before the role provider is called to check the list of roles at the data source. The cookie is dynamically updated to cache the most recently validated role names.

You can improve the reliability of the role names cached in a cookie by specifying a CookieProtectionValue property when you configure ASP.NET roles. The default CookieProtectionValue is All, which encrypts role names in the cookie and validates that the cookie contents have not been altered.


Because role names can be cached apart from the data source, it is possible that changes to role management at the data source would not be reflected in the cached values. In this case, the user must close and re-open their browser to clear the cached cookie value.

The following example shows the roleManager element in the system.web section of the Web.config file for an ASP.NET application. It specifies that the application uses a SqlRoleProvider instance and sets the cacheRolesInCookie attribute to true.

<roleManager defaultProvider="SqlProvider" 
  cookieProtection="All" >
      applicationName="MyApplication" />

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0