SessionPageStatePersister

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

SessionPageStatePersister クラス

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

ASP.NET ページのビューステートを Web サーバーに格納します。

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

Visual Basic (宣言)

Public Class SessionPageStatePersister
    Inherits PageStatePersister

Visual Basic (使用法)

Dim instance As SessionPageStatePersister

C#

public class SessionPageStatePersister : PageStatePersister

C++

public ref class SessionPageStatePersister
 : public PageStatePersister

J#

public class SessionPageStatePersister extends
 PageStatePersister

JScript

public class SessionPageStatePersister extends
 PageStatePersister

解説

ASP.NET ページでは、本質的には状態のない HTTP の要求と応答の間で、Web ページの処理および機能に必要な Page の状態情報を格納できます。この状態を "ビューステート" といいます。

既定の ASP.NET 永続化機構では、HiddenFieldPageStatePersister クラスを使用して、ビューステートをクライアントに格納します。個々の HTTP 要求と応答にビューステートおよびデータを格納する方法は、一般に問題なく機能し、大規模な Web ファーム構成では重要になります。この方法では、要求がどの Web サーバーで処理される場合でも、そのサーバーが現在のコンテキスト内におけるページの状態を取得してページを正確に表示できるからです。

クライアント側のリソースが制限されている小さいデバイスにページを送信する場合や、非表示のフィールド要素をサポートしないマークアップ言語を使用する場合には、ビューステートをサーバーに格納する必要があります。ASP.NET のいくつかのデバイス ページ アダプタでは、GetStatePersister メソッドをオーバーライドすることで、クライアントに関連付けられたセッション オブジェクトとしてサーバー上にページの状態を格納する SessionPageStatePersister オブジェクトを返します。

使用例

ビューステートをサーバー側のセッション オブジェクトに保存するために、既定の HiddenFieldPageStatePersister クラスではなく SessionPageStatePersister クラスのインスタンスを返す PageAdapter クラスを記述する方法を次のコード例に示します。

Visual Basic

Imports System.Web.UI

Namespace Samples.AspNet.VB

    Public Class MyPageAdapter
       Inherits System.Web.UI.Adapters.PageAdapter


       Public Overrides Function
 GetStatePersister() As PageStatePersister
          Return New SessionPageStatePersister(Page)
       End Function 'GetStatePersister

    End Class 'MyPageAdapter

End Namespace

C#

namespace Samples.AspNet.CS {

    using System.Web.UI;

    public class MyPageAdapter : System.Web.UI.Adapters.PageAdapter
 {

        public override PageStatePersister GetStatePersister()
 {
            return new SessionPageStatePersister(Page);
        }
    }
}

J#

package Samples.AspNet.JSL;

import System.Web.UI.*;

public class MyPageAdapter extends System.Web.UI.Adapters.PageAdapter
{
    public PageStatePersister GetStatePersister()
    {
        return new SessionPageStatePersister(this.get_Page());
    } //GetStatePersister
} //MyPageAdapter

継承階層

System.Object
   System.Web.UI.PageStatePersister
    System.Web.UI.SessionPageStatePersister

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
SessionPageStatePersister メンバ
System.Web.UI 名前空間
PageStatePersister クラス
HiddenFieldPageStatePersister クラス
PageAdapter

SessionPageStatePersister コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

HiddenFieldPageStatePersister クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    page As Page _
)

Visual Basic (使用法)

Dim page As Page

Dim instance As New SessionPageStatePersister(page)

C#

public SessionPageStatePersister (
    Page page
)

C++

public:
SessionPageStatePersister (
    Page^ page
)

J#

public SessionPageStatePersister (
    Page page
)

JScript

public function SessionPageStatePersister (
    page : Page
)

パラメータ

page

ビューステート永続化機構が作成される Page。

例外

例外の種類	条件
ArgumentException	HttpSessionState が null (Visual Basic の場合は Nothing) です。

使用例

ビューステートをサーバー側のセッション オブジェクトに保存するために、SessionPageStatePersister クラスのインスタンスを返す PageAdapter クラスを記述する方法を次のコード例に示します。

Visual Basic

Imports System.Web.UI

Namespace Samples.AspNet.VB

    Public Class MyPageAdapter
       Inherits System.Web.UI.Adapters.PageAdapter


       Public Overrides Function
 GetStatePersister() As PageStatePersister
          Return New SessionPageStatePersister(Page)
       End Function 'GetStatePersister

    End Class 'MyPageAdapter

End Namespace

C#

namespace Samples.AspNet.CS {

    using System.Web.UI;

    public class MyPageAdapter : System.Web.UI.Adapters.PageAdapter
 {

        public override PageStatePersister GetStatePersister()
 {
            return new SessionPageStatePersister(Page);
        }
    }
}

J#

package Samples.AspNet.JSL;

import System.Web.UI.*;

public class MyPageAdapter extends System.Web.UI.Adapters.PageAdapter
{
    public PageStatePersister GetStatePersister()
    {
        return new SessionPageStatePersister(this.get_Page());
    } //GetStatePersister
} //MyPageAdapter

プラットフォーム

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

参照

関連項目
SessionPageStatePersister クラス
SessionPageStatePersister メンバ
System.Web.UI 名前空間

SessionPageStatePersister プロパティ

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ControlState	オブジェクトを取得または設定します。このオブジェクトは、現在の Page オブジェクトによって格納されているコントロールが Web サーバーへの HTTP 要求間で永続化するために使用しているデータを表します。 ( PageStatePersister から継承されます。)
	ViewState	オブジェクトを取得または設定します。このオブジェクトは、現在の Page オブジェクトによって格納されているコントロールが Web サーバーへの HTTP 要求間で永続化するために使用しているデータを表します。 ( PageStatePersister から継承されます。)

プロテクト プロパティ

	名前	説明
	Page	ビューステート永続化機構が作成される対象の Page オブジェクトを取得または設定します。 ( PageStatePersister から継承されます。)
	StateFormatter	Save メソッドおよび Load メッソドへの呼び出しで、ViewState プロパティおよび ControlState プロパティに格納されている状態情報のシリアル化と逆シリアル化に使用する IStateFormatter オブジェクトを取得します。 ( PageStatePersister から継承されます。)

参照

関連項目

SessionPageStatePersister クラス
System.Web.UI 名前空間
PageStatePersister クラス
HiddenFieldPageStatePersister クラス
PageAdapter

SessionPageStatePersister メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Load	オーバーライドされます。 Page オブジェクトで、そのオブジェクトのコントロール階層を初期化する際は、サーバー側のセッション オブジェクトから、永続化されている状態を逆シリアル化して読み込みます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Save	オーバーライドされます。 ViewState プロパティまたは ControlState プロパティに含まれているオブジェクトの状態をシリアル化して、その状態をセッション オブジェクトに書き込みます。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

SessionPageStatePersister クラス
System.Web.UI 名前空間
PageStatePersister クラス
HiddenFieldPageStatePersister クラス
PageAdapter

SessionPageStatePersister メンバ

ASP.NET ページのビューステートを Web サーバーに格納します。

SessionPageStatePersister データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	SessionPageStatePersister	HiddenFieldPageStatePersister クラスの新しいインスタンスを初期化します。

パブリック プロパティ

( プロテクト プロパティ も参照)

	名前	説明
	ControlState	オブジェクトを取得または設定します。このオブジェクトは、現在の Page オブジェクトによって格納されているコントロールが Web サーバーへの HTTP 要求間で永続化するために使用しているデータを表します。 (PageStatePersister から継承されます。)
	ViewState	オブジェクトを取得または設定します。このオブジェクトは、現在の Page オブジェクトによって格納されているコントロールが Web サーバーへの HTTP 要求間で永続化するために使用しているデータを表します。 (PageStatePersister から継承されます。)

プロテクト プロパティ

	名前	説明
	Page	ビューステート永続化機構が作成される対象の Page オブジェクトを取得または設定します。(PageStatePersister から継承されます。)
	StateFormatter	Save メソッドおよび Load メッソドへの呼び出しで、ViewState プロパティおよび ControlState プロパティに格納されている状態情報のシリアル化と逆シリアル化に使用する IStateFormatter オブジェクトを取得します。(PageStatePersister から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Load	オーバーライドされます。 Page オブジェクトで、そのオブジェクトのコントロール階層を初期化する際は、サーバー側のセッション オブジェクトから、永続化されている状態を逆シリアル化して読み込みます。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Save	オーバーライドされます。 ViewState プロパティまたは ControlState プロパティに含まれているオブジェクトの状態をシリアル化して、その状態をセッション オブジェクトに書き込みます。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

SessionPageStatePersister クラス
System.Web.UI 名前空間
PageStatePersister クラス
HiddenFieldPageStatePersister クラス
PageAdapter