RoleManagerSection.CacheRolesInCookie Propriété

Définition

Espace de noms:

System.Web.Configuration

Assembly:

System.Web.dll

Obtient ou définit une valeur indiquant si les rôles de l'utilisateur en cours sont cachés dans un cookie.

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

[System.Configuration.ConfigurationProperty("cacheRolesInCookie", DefaultValue=false)]
public bool CacheRolesInCookie { get; set; }

[<System.Configuration.ConfigurationProperty("cacheRolesInCookie", DefaultValue=false)>]
member this.CacheRolesInCookie : bool with get, set

Public Property CacheRolesInCookie As Boolean

Valeur de propriété

Boolean

true si les rôles de l'utilisateur en cours sont mis en cache dans un cookie; sinon, false. La valeur par défaut est false.

Attributs

ConfigurationPropertyAttribute

Exemples

L’exemple de code suivant montre comment utiliser la CacheRolesInCookie propriété. Cet exemple de code fait partie d’un exemple plus grand fourni pour la RoleManagerSection classe.

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

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

Remarques

La CacheRolesInCookie propriété retourne une valeur booléenne indiquant si le stockage de cookies pour les noms de rôles est activé.

Lorsque la CacheRolesInCookie propriété est définie true dans le fichier de configuration, les informations de rôle pour chaque utilisateur sont stockées dans un cookie sur le client. Lorsque la gestion des rôles vérifie si un utilisateur est dans un rôle particulier, le cookie de rôles est vérifié avant d’appeler le fournisseur de rôles pour vérifier la liste des rôles à la source de données. Le cookie est mis à jour dynamiquement sur le client pour mettre en cache les noms de rôles les plus récemment validés.

Vous pouvez améliorer la fiabilité des noms de rôles mis en cache dans un cookie en spécifiant une CookieProtection propriété lorsque vous configurez la roleManager section du fichier de configuration. La propriété par défaut CookieProtection est All, qui chiffre les noms de rôle dans le cookie et valide que le contenu du cookie n’a pas été modifié.