SessionAuthenticationModule.IsReferenceMode プロパティ

定義

名前空間:

System.IdentityModel.Services

アセンブリ:

System.IdentityModel.Services.dll

セッション情報 (クレーム値など) をセッション クッキーに保存するか、またはセッションの内容を、クッキーを使用して参照だけを保存することにより、サーバー側で保存するかを指定する値を取得または設定します。

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

発行されたクッキーが参照モードの場合は true。それ以外の場合は false。 既定値は false で、これは発行されたクッキーが参照モードでないことを示します。

注釈

参照モードでは、 SessionSecurityToken はサーバー側キャッシュ (から SessionSecurityTokenCache派生したオブジェクト) に格納されます。 発行された Cookie には、キャッシュからトークンを取得するために使用されるコンテキスト識別子だけが含まれています。

重要

参照モードで動作するために、Microsoft では、global.asax.cs ファイルで イベントのWSFederationAuthenticationModule.SessionSecurityTokenCreatedハンドラーを提供し、 プロパティで渡されたトークンに プロパティをSessionSecurityTokenCreatedEventArgs.SessionToken設定SessionSecurityToken.IsReferenceModeすることをお勧めします。 これにより、セッション トークンがすべての要求に対して参照モードで動作し、単にセッション認証モジュールで プロパティを SessionAuthenticationModule.IsReferenceMode 設定するよりも優先されます。