SessionPageStatePersister クラス

定義

名前空間:

System.Web.UI

アセンブリ:

System.Web.dll

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

public ref class SessionPageStatePersister : System::Web::UI::PageStatePersister

public class SessionPageStatePersister : System.Web.UI.PageStatePersister

type SessionPageStatePersister = class
    inherit PageStatePersister

Public Class SessionPageStatePersister
Inherits PageStatePersister

継承

Object

PageStatePersister

SessionPageStatePersister

例

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

namespace Samples.AspNet.CS {

    using System.Web.UI;

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

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

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

End Namespace

注釈

ASP.NET ページでは、本質的にステートレスな HTTP 要求と、任意の Web ページの処理と処理に必要な応答の間に状態情報を格納Pageできます。 この状態は "ビューステート" と呼ばれます。

既定の ASP.NET 永続化メカニズムは、クラスを使用してクライアントにビューステートをHiddenFieldPageStatePersister格納することです。 各 HTTP 要求と応答を使用してビューステートとデータを格納することは一般的に良好に機能し、大規模な Web ファームシナリオでは重要です。これは、どの Web サーバーが要求を処理するかは関係ないためです。ページの状態は、サーバーがページを正確にレンダリングするために現在のコンテキストで使用できます。

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

コンストラクター

SessionPageStatePersister(Page)

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

プロパティ

ControlState	オブジェクトを取得または設定します。このオブジェクトは、現在の Page オブジェクトによって格納されているコントロールが Web サーバーへの HTTP 要求間で永続化するために使用しているデータを表します。 (継承元 PageStatePersister)
Page	ビューステート永続化機構が作成される対象の Page オブジェクトを取得または設定します。 (継承元 PageStatePersister)
StateFormatter	IStateFormatter メソッドおよび ViewState メッソドへの呼び出しで、ControlState プロパティおよび Save() プロパティに格納されている状態情報のシリアル化と逆シリアル化に使用する Load() オブジェクトを取得します。 (継承元 PageStatePersister)
ViewState	オブジェクトを取得または設定します。このオブジェクトは、現在の Page オブジェクトによって格納されているコントロールが Web サーバーへの HTTP 要求間で永続化するために使用しているデータを表します。 (継承元 PageStatePersister)

メソッド

Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Load()	Page オブジェクトで、そのオブジェクトのコントロール階層を初期化する際は、サーバー側のセッション オブジェクトから、永続化されている状態を逆シリアル化して読み込みます。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
Save()	ViewState プロパティまたは ControlState プロパティに含まれているオブジェクトの状態をシリアル化して、その状態をセッション オブジェクトに書き込みます。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

こちらもご覧ください

• PageStatePersister
• HiddenFieldPageStatePersister
• PageAdapter