SessionAuthenticationModule.IsReferenceMode Propriété

Définition

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.Gets or sets a value that specifies whether the session information (claim values, etc.) should be stored in the session cookie or whether the session content should be stored on the server side, using the cookie to store just a reference.

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.true if issued cookies are in reference mode; otherwise, false. La valeur par défaut est false, ce qui indique que les cookies émis ne sont pas en mode référence.The default is false, which specifies that issued cookies are not in reference mode.

Remarques

En mode de référence, le SessionSecurityToken est stocké dans un cache côté serveur (un objet qui dérive de SessionSecurityTokenCache ).In reference mode, the SessionSecurityToken is stored in a server-side cache (an object that derives from SessionSecurityTokenCache). Le cookie émis contient simplement un identificateur de contexte qui est utilisé pour récupérer le jeton à partir du cache.The issued cookie just contains a context identifier that is used to retrieve the token from the cache.

Important

Pour fonctionner en mode de référence, Microsoft recommande de fournir un gestionnaire pour l' WSFederationAuthenticationModule.SessionSecurityTokenCreated événement 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é.To operate in reference mode, Microsoft recommends providing a handler for the WSFederationAuthenticationModule.SessionSecurityTokenCreated event in the global.asax.cs file and setting the SessionSecurityToken.IsReferenceMode property on the token passed in the SessionSecurityTokenCreatedEventArgs.SessionToken property. Cela permet de s’assurer que le jeton de session fonctionne en mode de référence pour chaque demande et qu’il est préférable de définir simplement la SessionAuthenticationModule.IsReferenceMode propriété sur le module d’authentification de session.This will ensure that the session token operates in reference mode for every request and is favored over merely setting the SessionAuthenticationModule.IsReferenceMode property on the Session Authentication Module.

S’applique à