ISessionIDManager.InitializeRequest メソッド

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

ISessionIDManager.InitializeRequest メソッド

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

SessionIDManager オブジェクトの要求ごとの初期化を実行します。

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

Visual Basic (宣言)

Function InitializeRequest ( _
    context As HttpContext, _
    suppressAutoDetectRedirect As Boolean,
 _
    <OutAttribute> ByRef supportSessionIDReissue As
 Boolean _
) As Boolean

Visual Basic (使用法)

Dim instance As ISessionIDManager
Dim context As HttpContext
Dim suppressAutoDetectRedirect As Boolean
Dim supportSessionIDReissue As Boolean
Dim returnValue As Boolean

returnValue = instance.InitializeRequest(context, suppressAutoDetectRedirect, supportSessionIDReissue)

C#

bool InitializeRequest (
    HttpContext context,
    bool suppressAutoDetectRedirect,
    out bool supportSessionIDReissue
)

C++

bool InitializeRequest (
    HttpContext^ context, 
    bool suppressAutoDetectRedirect, 
    [OutAttribute] bool% supportSessionIDReissue
)

J#

boolean InitializeRequest (
    HttpContext context, 
    boolean suppressAutoDetectRedirect, 
    /** @attribute OutAttribute() */ /** @ref */ boolean supportSessionIDReissue
)

JScript

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

パラメータ

context

現在の要求に関する情報を保持している HttpContext オブジェクト。

suppressAutoDetectRedirect

セッション ID マネージャが Cookie のサポートを確認するためにリダイレクトする必要がある場合は true。それ以外の場合は false に設定し、Cookie のサポートを確認するための自動リダイレクトを抑止します。

supportSessionIDReissue

このメソッドが返されるときに、元の ID の有効期限が切れている場合、ISessionIDManager オブジェクトが新しいセッション ID を発行できるかどうかを示すブール値を格納します。このパラメータは初期化せずに渡されます。

セッション ID の再利用は、セッション状態 ID が URL にエンコードされ、URL が共有されるか、または電子メールで送信される可能性がある場合に適しています。

カスタムのセッション状態の実装が仮想パスによって Cookie を区切っている場合も、セッション状態をサポートする必要があります。

戻り値
初期化がリダイレクトを実行した場合は true。それ以外の場合は false。

解説

ISessionIDManager オブジェクトが処理する各要求に対して、InitializeRequest メソッドが呼び出されます。SessionIDManager オブジェクトを要求データごとに初期化するには、InitializeRequest メソッドを使用します。

suppressAutoDetectRedirect パラメータが true の場合、ISessionIDManager オブジェクトはリダイレクトを使用してブラウザが Cookie をサポートするかどうかを確認する必要はありません。

セッションの識別に Cookie を使用する場合、supportSessionIDReissue パラメータは false を返す必要があります。それ以外の場合、ISessionIDManager の実装がセッション ID の再発行をサポートする場合は 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

参照

関連項目
ISessionIDManager インターフェイス
ISessionIDManager メンバ
System.Web.SessionState 名前空間