SessionAuthenticationModule.IsReferenceMode Propriété

Définition

Espace de noms:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Obtient ou définit une valeur qui spécifie si les informations de session (valeurs de revendication, etc.) doivent être stockées dans le cookie de session ou si le contenu de session doit être stocké côté serveur, en utilisant le cookie pour stocker simplement une référence.

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

public bool IsReferenceMode { get; set; }

member this.IsReferenceMode : bool with get, set

Public Property IsReferenceMode As Boolean

Valeur de propriété

Boolean

true si les cookies sont publiés en mode référence ; sinon, false. La valeur par défaut est false, ce qui indique que les cookies émis ne sont pas en mode référence.

Remarques

En mode référence, le SessionSecurityToken est stocké dans un cache côté serveur (objet qui dérive de SessionSecurityTokenCache). Le cookie émis contient simplement un identificateur de contexte utilisé pour récupérer le jeton à partir du cache.

Important

Pour fonctionner en mode référence, Microsoft recommande de fournir un gestionnaire pour l’événement WSFederationAuthenticationModule.SessionSecurityTokenCreated dans le fichier global.asax.cs et de définir la SessionSecurityToken.IsReferenceMode propriété sur le jeton passé dans la SessionSecurityTokenCreatedEventArgs.SessionToken propriété. Cela garantit que le jeton de session fonctionne en mode référence pour chaque requête et est préféré à la simple définition de la SessionAuthenticationModule.IsReferenceMode propriété sur le module d’authentification de session.