SessionPageStatePersister SessionPageStatePersister SessionPageStatePersister SessionPageStatePersister Class

定義

ASP.NET ページのビューステートを Web サーバーに格納します。Stores ASP.NET page view state on the Web server.

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
継承
SessionPageStatePersisterSessionPageStatePersisterSessionPageStatePersisterSessionPageStatePersister

次のコード例は、サーバー側のセッションPageAdapterオブジェクトにビューステートを保存するSessionPageStatePersisterために、既定HiddenFieldPageStatePersisterのクラスではなくクラスのインスタンスを返すクラスを記述する方法を示しています。The following code example demonstrates how you can write a PageAdapter class to return an instance of the SessionPageStatePersister class instead of the default HiddenFieldPageStatePersister class to save view state to the server-side session object.

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 ページは、 Page任意の Web ページを処理して使用するために必要な、本質的にステートレスな HTTP 要求と応答の間の状態情報を格納できます。ASP.NET pages can store Page state information between the inherently stateless HTTP request and response required to process and serve any Web page. この状態は、"ビューステート" と呼ばれます。This state is called "view state."

既定の ASP.NET 永続化メカニズムでは、 HiddenFieldPageStatePersisterクラスを使用してクライアントにビューステートを格納します。The default ASP.NET persistence mechanism is to store view state on the client using the HiddenFieldPageStatePersister class. ビューステートとデータを各 HTTP 要求および応答と共に格納することは、一般的には正常に実行されます。 web ファームの大規模なシナリオでは、要求を処理する Web サーバーではなく、ページの状態を現在のコンテキストで使用できます。ページを正確にレンダリングします。Storing view state and data with each HTTP request and response performs well in general and is important in large Web farm scenarios because it does not matter which Web server services the request: the page state is available in the current context for the server to accurately render the page.

クライアント側リソースが制限されている小さいデバイスにページが提供される場合や、隠しフィールド要素をサポートしないマークアップ言語を使用する場合は、ビューステートをサーバーに保存する必要があります。In scenarios where pages are served to small devices that have limited client-side resources or use a markup language that does not support a hidden field element, it is required to store view state on the server. いくつかの ASP.NET デバイスページアダプター GetStatePersisterは、メソッドをSessionPageStatePersisterオーバーライドして、クライアントに関連付けられているセッションオブジェクトのサーバーにページの状態を格納するオブジェクトを返します。Several ASP.NET device page adapters override the GetStatePersister method to return a SessionPageStatePersister object that stores page state on the server in the session object associated with the client.

コンストラクター

SessionPageStatePersister(Page) SessionPageStatePersister(Page) SessionPageStatePersister(Page) SessionPageStatePersister(Page)

SessionPageStatePersister クラスの新しいインスタンスを初期化します。Initializes a new instance of the SessionPageStatePersister class.

メソッド

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
Load() Load() Load() Load()

Page オブジェクトで、そのオブジェクトのコントロール階層を初期化する際は、サーバー側のセッション オブジェクトから、永続化されている状態を逆シリアル化して読み込みます。Deserializes and loads persisted state from the server-side session object when a Page object initializes its control hierarchy.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
Save() Save() Save() Save()

ViewState プロパティまたは ControlState プロパティに含まれているオブジェクトの状態をシリアル化して、その状態をセッション オブジェクトに書き込みます。Serializes any object state contained in the ViewState or the ControlState property and writes the state to the session object.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

プロパティ

ControlState ControlState ControlState ControlState

オブジェクトを取得または設定します。このオブジェクトは、現在の Page オブジェクトによって格納されているコントロールが Web サーバーへの HTTP 要求間で永続化するために使用しているデータを表します。Gets or sets an object that represents the data that controls contained by the current Page object use to persist across HTTP requests to the Web server.

(Inherited from PageStatePersister)
Page Page Page Page

ビューステート永続化機構が作成される対象の Page オブジェクトを取得または設定します。Gets or sets the Page object that the view state persistence mechanism is created for.

(Inherited from PageStatePersister)
StateFormatter StateFormatter StateFormatter StateFormatter

IStateFormatter メソッドおよび ViewState メッソドへの呼び出しで、ControlState プロパティおよび Save() プロパティに格納されている状態情報のシリアル化と逆シリアル化に使用する Load() オブジェクトを取得します。Gets an IStateFormatter object that is used to serialize and deserialize the state information contained in the ViewState and ControlState properties during calls to the Save() and Load() methods.

(Inherited from PageStatePersister)
ViewState ViewState ViewState ViewState

オブジェクトを取得または設定します。このオブジェクトは、現在の Page オブジェクトによって格納されているコントロールが Web サーバーへの HTTP 要求間で永続化するために使用しているデータを表します。Gets or sets an object that represents the data that controls contained by the current Page object use to persist across HTTP requests to the Web server.

(Inherited from PageStatePersister)

適用対象

こちらもご覧ください