SessionIDManager.SaveSessionID メソッド

.NET Framework クラス ライブラリ リファレンス

SessionIDManager.SaveSessionID メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

新規作成されたセッション識別子を HTTP 応答に保存します。

名前空間: System.Web.SessionState
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub SaveSessionID ( _
    context As HttpContext, _
    id As String, _
    <OutAttribute> ByRef redirected As
 Boolean, _
    <OutAttribute> ByRef cookieAdded As
 Boolean _
)

Visual Basic (使用法)

Dim instance As SessionIDManager
Dim context As HttpContext
Dim id As String
Dim redirected As Boolean
Dim cookieAdded As Boolean

instance.SaveSessionID(context, id, redirected, cookieAdded)

C#

public void SaveSessionID (
    HttpContext context,
    string id,
    out bool redirected,
    out bool cookieAdded
)

C++

public:
virtual void SaveSessionID (
    HttpContext^ context, 
    String^ id, 
    [OutAttribute] bool% redirected, 
    [OutAttribute] bool% cookieAdded
) sealed

J#

public final void SaveSessionID (
    HttpContext context, 
    String id, 
    /** @attribute OutAttribute() */ /** @ref */ boolean redirected, 
    /** @attribute OutAttribute() */ /** @ref */ boolean cookieAdded
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

context

Request プロパティ、Response プロパティなどの HTTP 要求を処理するためのサーバー オブジェクトを参照する現在の HttpContext オブジェクト。

id

セッション識別子。

redirected

このメソッドが返されるときに、セッション識別子が URL に追加された状態で応答が現在の URL にリダイレクトされた場合は true のブール値を格納します。それ以外の場合は false を格納します。

cookieAdded

このメソッドが返されるときに、Cookie が HTTP 応答に追加された場合は true のブール値を格納します。それ以外の場合は false を格納します。

例外

例外の種類	条件
HttpException	応答が既に送信されています。 または このメソッドに渡されたセッション ID の検証は失敗しました。

解説

このメソッドは、アプリケーション コードから呼び出すためのものではありません。

AcquireRequestState イベントの発生中に、SessionStateModule オブジェクトによって SaveSessionID メソッドが呼び出されます。SaveSessionID メソッドは、URL (cookieless セッション状態を使用する場合) または無期限のセッション Cookie にセッション識別子を保存します。

既定では、SessionIDManager は一意のセッション識別子を無期限のセッション Cookie に配置し、cookieAdded パラメータを true に設定します。

cookieless セッション状態の場合、SessionIDManager オブジェクトは、一意のセッション識別子を現在の URL に挿入し、そのセッション識別子を含む新しい URL にブラウザをリダイレクトし、redirected パラメータを true に設定します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SessionIDManager クラス
SessionIDManager メンバ
System.Web.SessionState 名前空間
その他の技術情報
ASP.NET のセッション状態