HiddenFieldPageStatePersister Klasa

Definicja

Przechowuje stan widoku strony ASP.NET na kliencie sieci Web w ukrytym elemencie 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
Dziedziczenie
HiddenFieldPageStatePersister

Przykłady

Poniższy przykład kodu demonstruje sposób powiązania ListBox kontrolki z danymi w bazie danych z SqlDataSource kontrolką.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>

Gdy zostanie wyświetlona strona przykładowa, wszystkie Stany widoku są przechowywane przez HiddenFieldPageStatePersister klasę w <hidden> elemencie HTML o nazwie "__VIEWSTATE".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>  

Uwagi

Strony ASP.NET mogą przechowywać Page stan między bezstanowym żądaniem http i odpowiedzią wymaganą do przetworzenia i obsłużenia dowolnej strony sieci Web.ASP.NET pages can store Page state between the inherently stateless HTTP request and response required to process and serve any Web page. Ten stan jest nazywany "Wyświetl stan".This state is called "view state". Domyślny mechanizm używany do przechowywania stanu widoku dla strony i jej formantów znajduje się w co najmniej jednym <hidden> polu HTML uwzględnionym na stronie, która jest obsługiwana dla klienta z serwera sieci Web.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. PageKlasa może HiddenFieldPageStatePersister wykonać tę czynność przy użyciu klasy.The Page class can use the HiddenFieldPageStatePersister class to do this work. HiddenFieldPageStatePersister implementuje Save metody i Load PageStatePersister klasy, aby Page można było przechowywać stan w <hidden> elemencie HTML o nazwie "__VIEWSTATE" na kliencie sieci Web.HiddenFieldPageStatePersister 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. Gdy klient żąda tej samej strony od serwera sieci Web (ogłaszania zwrotnego), <hidden> element jest analizowany i konwertowany na informacje o stanie przez 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.

Jeśli Page żądane wystąpienie ma skojarzoną PageAdapter klasę, pobiera PageStatePersister obiekt z tej karty przy użyciu GetStatePersister metody.If the Page instance that is requested has an associated PageAdapter class, it retrieves the PageStatePersister object from this adapter using the GetStatePersister method. Karty mogą przesłaniać GetStatePersister metodę, aby zwrócić PageStatePersister obiekt przechowujący stan strony i kontroli w jakiś sposób, który obsługuje określony klient.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. Na przykład SessionPageStatePersister Klasa przechowuje stan strony i kontrolek na serwerze sieci Web, a nie na kliencie, aby zmniejszyć ilość informacji, które muszą być wysyłane i przechowywane na kliencie, który ma potencjalnie ograniczoną ilość pamięci i przepustowości.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.

Maksymalny rozmiar elementu HTML "_VIEWSTATE" <hidden> można ustawić za pomocą MaxPageStateFieldLength właściwości lub MaxPageStateFieldLength Ustawienia konfiguracji.The maximum size of the "_VIEWSTATE" <hidden> HTML element can be set through the MaxPageStateFieldLength property or through the MaxPageStateFieldLength configuration setting. Gdy ta wartość jest ustawiona, a długość elementu "_VIEWSTATE" przekroczyłaby maksymalną długość, zawartość jest dzielona na wiele elementów "_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.

Konstruktory

HiddenFieldPageStatePersister(Page)

Inicjuje nowe wystąpienie klasy HiddenFieldPageStatePersister.Initializes a new instance of the HiddenFieldPageStatePersister class.

Właściwości

ControlState

Pobiera lub ustawia obiekt reprezentujący dane, które kontrolki zawarte w bieżącym Page obiekcie używają do zachowywania żądań HTTP do serwera sieci Web.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.

(Odziedziczone po PageStatePersister)
Page

Pobiera lub ustawia Page obiekt, dla którego jest tworzony mechanizm trwałości stanu widoku.Gets or sets the Page object that the view state persistence mechanism is created for.

(Odziedziczone po PageStatePersister)
StateFormatter

Pobiera IStateFormatter obiekt, który jest używany do serializacji i deserializacji informacji o stanie zawartych we ViewState ControlState właściwościach i podczas wywołań Save() metod i 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.

(Odziedziczone po PageStatePersister)
ViewState

Pobiera lub ustawia obiekt reprezentujący dane, które kontrolki zawarte w bieżącym Page obiekcie używają do zachowywania żądań HTTP do serwera sieci Web.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.

(Odziedziczone po PageStatePersister)

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
Load()

Deserializacji i ładuje informacje o stanie utrwalonym z HttpRequest obiektu, gdy Page obiekt inicjuje swoją hierarchię kontroli.Deserializes and loads persisted state information from an HttpRequest object when a Page object initializes its control hierarchy.

MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Save()

Serializować wszystkie Stany obiektów zawarte we ViewState ControlState właściwości lub i zapisuje stan do strumienia odpowiedzi.Serializes any object state contained in the ViewState or ControlState property and writes the state to the response stream.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy

Zobacz też