SessionStateStoreProviderBase.CreateUninitializedItem メソッド

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

SessionStateStoreProviderBase.CreateUninitializedItem メソッド

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

新しいセッション状態項目をデータ ストアに追加します。

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

Visual Basic (宣言)

Public MustOverride Sub
 CreateUninitializedItem ( _
    context As HttpContext, _
    id As String, _
    timeout As Integer _
)

Visual Basic (使用法)

Dim instance As SessionStateStoreProviderBase
Dim context As HttpContext
Dim id As String
Dim timeout As Integer

instance.CreateUninitializedItem(context, id, timeout)

C#

public abstract void CreateUninitializedItem
 (
    HttpContext context,
    string id,
    int timeout
)

C++

public:
virtual void CreateUninitializedItem (
    HttpContext^ context, 
    String^ id, 
    int timeout
) abstract

J#

public abstract void CreateUninitializedItem
 (
    HttpContext context, 
    String id, 
    int timeout
)

JScript

public abstract function CreateUninitializedItem
 (
    context : HttpContext, 
    id : String, 
    timeout : int
)

パラメータ

context

現在の要求に関する HttpContext。

id

現在の要求に関する SessionID。

timeout

現在の要求に関するセッション Timeout。

解説

cookieless 属性と regenerateExpiredSessionId 属性が共に true の場合、セッションに CreateUninitializedItem メソッドが使用されます。regenerateExpiredSessionId attribute を true に設定すると、SessionStateModule オブジェクトは有効期限切れの SessionID に対して SessionID 値を新規に作成します。

SessionID 値を新規作成するプロセスでは、新規作成された SessionID 値を含む URL にブラウザをリダイレクトする必要があります。CreateUninitializedItem メソッドは、有効期限切れの SessionID 値を含む要求を最初に行う際に呼び出されます。SessionStateModule オブジェクトは、新しい SessionID 値を受け取って有効期限切れの値を置き換えた後、CreateUninitializedItem メソッドを呼び出してセッション状態データ ストアに初期化されていないエントリを追加します。ブラウザは新規作成された SessionID 値を含む URL にリダイレクトされます。セッション データ ストアには初期化されていないエントリがあるので、新規作成された SessionID 値を含むリダイレクトされた要求が有効期限切れのセッションに対する要求と混同されることはなく、新しいセッションとして処理されます。

セッション データ ストアの初期化されていないエントリは、新規作成された SessionID 値に関連付けられ、有効期限の日時、GetItem メソッドと GetItemExclusive メソッドの actionFlags パラメータに対応する値などの既定値のみを含みます。セッション状態ストアの初期化されていないエントリは、InitializeItem 列挙値に等しい actionFlags 値を含む必要があります。この値は GetItem メソッドおよび GetItemExclusive メソッドによって SessionStateModule オブジェクトに渡され、現在のセッションは初期化されていない新しいセッションであることを SessionStateModule オブジェクトに通知します。その後、SessionStateModule オブジェクトは新しいセッションを初期化し、Session_OnStart イベントを発生させます。

cookieless セッションの詳細については、IsCookieless プロパティを参照してください。

使用例

セッション状態ストア プロバイダの実装の例については、「セッション状態ストア プロバイダの実装」を参照してください。

プラットフォーム

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

参照

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