SessionAuthenticationModule.IsReferenceMode 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取或设置一个值，该值指定是否应在会话 Cookie 中存储会话信息（声明值等），或是否应通过使用 Cookie 仅存储引用在服务器端上存储会话内容。

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

Boolean

如果发布的 cookies 在引用模式中，则为 true；否则为 false。默认值为 false，指定了发布的 cookie 不处于引用模式。

在引用模式下， SessionSecurityToken 存储在服务器端缓存中， (派生自 SessionSecurityTokenCache) 的对象。颁发的 Cookie 仅包含用于从缓存中检索令牌的上下文标识符。

重要

若要在引用模式下运行，Microsoft 建议在 global.asax.cs 文件中为 WSFederationAuthenticationModule.SessionSecurityTokenCreated 事件提供处理程序，并在属性中传递的令牌上设置 SessionSecurityToken.IsReferenceMode 属性 SessionSecurityTokenCreatedEventArgs.SessionToken 。这将确保会话令牌在每个请求的引用模式下运行，并且优先于仅在会话身份验证模块上设置 SessionAuthenticationModule.IsReferenceMode 属性。