HiddenFieldPageStatePersister HiddenFieldPageStatePersister HiddenFieldPageStatePersister HiddenFieldPageStatePersister Class

定義

Web クライアント上の ASP.NET ページのビューステートを非表示の HTML 要素に格納します。Stores ASP.NET page view state on the Web client in a hidden HTML element.

public ref class HiddenFieldPageStatePersister : System::Web::UI::PageStatePersister
public class HiddenFieldPageStatePersister : System.Web.UI.PageStatePersister
type HiddenFieldPageStatePersister = class
    inherit PageStatePersister
Public Class HiddenFieldPageStatePersister
Inherits PageStatePersister
継承
HiddenFieldPageStatePersisterHiddenFieldPageStatePersisterHiddenFieldPageStatePersisterHiddenFieldPageStatePersister

次のコード例は、コントロールをListBox SqlDataSource使用してデータベースのデータにコントロールをバインドする方法を示しています。The following code example demonstrates how to bind a ListBox control to data in a database with a SqlDataSource control.

<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

    </form>
  </body>
</html>
<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

    </form>
  </body>
</html>

このページが表示されると、ビューステートは、 HiddenFieldPageStatePersisterクラスによって "__VIEWSTATE" という名前の<hidden> HTML 要素に格納されます。When the example page is viewed, any view state is stored by the HiddenFieldPageStatePersister class in a <hidden> HTML element named "__VIEWSTATE".

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">  
<HTML>  
  <BODY>  
    <form name="_ctl0" method="post" action="sample.aspx" id="_ctl0">  

      <input type="hidden" name="__VIEWSTATE" value="MgAwADkANgAwADkAOQA3ADgAMQD/AQ8QBQoxMTU2NDc1NjE0EGRkFgICAQ9kFgICAw8PZBAVDQVhc2RhcwhCdWNoYW5hbghDYWxsYWhhbgdEYXZvbGlvCURvZHN3b3J0aAZGdWxsZXIES2luZwhLcmF3YXJpawlMZXZlcmxpbmcETWFyeQdQZWFjb2NrBlN1eWFtYQx0ZXN0IHJlZnJlc2gVDQVhc2RhcwhCdWNoYW5hbghDYWxsYWhhbgdEYXZvbGlvCURvZHN3b3J0aAZGdWxsZXIES2luZwhLcmF3YXJpawlMZXZlcmxpbmcETWFyeQdQZWFjb2NrBlN1eWFtYQx0ZXN0IHJlZnJlc2gUKgMNZ2dnZ2dnZ2dnZ2dnZ2RkZPdhi6U7jBPqVZbj0W8AYFSJ6oiq" />  

      <select size="4" name="ListBox1" id="ListBox1">      
        <option value="Buchanan">Buchanan</option>  
        <option value="Callahan">Callahan</option>  
        <option value="Davolio">Davolio</option>  
        <option value="Dodsworth">Dodsworth</option>  
        <option value="Fuller">Fuller</option>  
        <option value="King">King</option>  
        <option value="Leverling">Leverling</option>  
        <option value="Suyama">Suyama</option>  
      </select>  

    </form>  
  </BODY>  
</HTML>  

注釈

ASP.NET ページではPage 、任意の Web ページを処理して使用するために必要な、本質的にステートレスな HTTP 要求と応答の間に状態を格納できます。ASP.NET pages can store Page state between the inherently stateless HTTP request and response required to process and serve any Web page. この状態は、"ビューステート" と呼ばれます。This state is called "view state". ページとそのコントロールのビューステートを格納するために使用される既定の機構は<hidden> 、Web サーバーからクライアントに提供されるページに含まれる1つまたは複数の HTML フィールドです。The default mechanism used to store view state for a page and its controls is in one or more <hidden> HTML fields included in the page that is served to a client from a Web server. クラスは、 HiddenFieldPageStatePersisterクラスを使用してこの作業を実行できます。 PageThe Page class can use the HiddenFieldPageStatePersister class to do this work. HiddenFieldPageStatePersisterLoad Page <hidden>クラスのメソッドとメソッドを実装して、が Web クライアント上の "__VIEWSTATE" という名前の HTML 要素に状態を格納できるようにします。 Save PageStatePersisterHiddenFieldPageStatePersister implements the Save and Load methods of the PageStatePersister class so that the Page can store state in a <hidden> HTML element named "__VIEWSTATE" on a Web client. クライアントが Web サーバー (ポストバック) <hidden>から同じページを要求すると、要素が解析され、ASP.NET によって状態情報に変換されます。When the client requests the same page from the Web server (a postback), the <hidden> element is parsed and converted to state information by ASP.NET.

要求されたPageAdapter PageStatePersister GetStatePersisterインスタンスに関連付けられているクラスがある場合は、メソッドを使用して、このアダプターからオブジェクトを取得します。 PageIf the Page instance that is requested has an associated PageAdapter class, it retrieves the PageStatePersister object from this adapter using the GetStatePersister method. アダプターは、メソッドGetStatePersisterをオーバーライドしてPageStatePersister 、特定のクライアントがサポートする何らかの方法でページおよびコントロールの状態を格納するオブジェクトを返すことができます。Adapters can override the GetStatePersister method to return a PageStatePersister object that stores page and control state in some way that a specific client supports. たとえば、クラスはSessionPageStatePersister 、ページとコントロールの状態をクライアントではなく Web サーバー上に格納して、メモリと帯域幅が制限される可能性があるクライアントに送信して保存する必要がある情報の量を減らします。For example, the SessionPageStatePersister class stores page and controls' state on the Web server, instead of the client, to decrease the amount of information that must be sent and stored on a client that has potentially limited memory and bandwidth.

"VIEWSTATE" <hidden> HTML 要素の最大サイズは、 MaxPageStateFieldLengthプロパティまたはMaxPageStateFieldLength構成設定を使用して設定できます。The maximum size of the "_VIEWSTATE" <hidden> HTML element can be set through the MaxPageStateFieldLength property or through the MaxPageStateFieldLength configuration setting. この値が設定されていて、"VIEWSTATE" 要素の長さが最大長を超えている場合、コンテンツは複数の "VIEWSTATE" 要素に分割されます。When this value is set and the length of the "_VIEWSTATE" element would exceed the maximum length, the content is divided into multiple "_VIEWSTATE" elements.

コンストラクター

HiddenFieldPageStatePersister(Page) HiddenFieldPageStatePersister(Page) HiddenFieldPageStatePersister(Page) HiddenFieldPageStatePersister(Page)

HiddenFieldPageStatePersister クラスの新しいインスタンスを初期化します。Initializes a new instance of the HiddenFieldPageStatePersister 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()

HttpRequest オブジェクトでそのコントロール階層を初期化する場合、保持されているステータス情報を Page オブジェクトから逆シリアル化して読み込みます。Deserializes and loads persisted state information from an HttpRequest 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 ControlState property and writes the state to the response stream.

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)

適用対象

こちらもご覧ください