HiddenFieldPageStatePersister Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Almacena el estado de vista de una página ASP.NET en el cliente Web, en un elemento HTML oculto.

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

Herencia: Object

PageStatePersister
HiddenFieldPageStatePersister

Ejemplos

En el ejemplo de código siguiente se muestra cómo enlazar un ListBox control a los datos de una base de datos con un 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>

Cuando se ve la página de ejemplo, la HiddenFieldPageStatePersister clase almacena cualquier estado de vista en un <hidden> elemento HTML denominado "__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>

Comentarios

ASP.NET páginas pueden almacenar Page el estado entre la solicitud HTTP sin estado inherente y la respuesta necesaria para procesar y atender cualquier página web. Este estado se denomina "estado de vista". El mecanismo predeterminado que se usa para almacenar el estado de vista de una página y sus controles se encuentra en uno o varios <hidden> campos HTML incluidos en la página que se sirve a un cliente desde un servidor web. La Page clase puede usar la HiddenFieldPageStatePersister clase para realizar este trabajo. HiddenFieldPageStatePersister implementa los Save métodos y Load de la PageStatePersister clase para que pueda almacenar el Page estado en un <hidden> elemento HTML denominado "__VIEWSTATE" en un cliente web. Cuando el cliente solicita la misma página desde el servidor web (un postback), el <hidden> elemento se analiza y convierte en información de estado por ASP.NET.

Si la Page instancia solicitada tiene una clase asociada PageAdapter , recupera el PageStatePersister objeto de este adaptador mediante el GetStatePersister método . Los adaptadores pueden invalidar el GetStatePersister método para devolver un PageStatePersister objeto que almacena el estado de página y control de alguna manera que admite un cliente específico. Por ejemplo, la clase almacena el SessionPageStatePersister estado de la página y los controles en el servidor web, en lugar del cliente, para reducir la cantidad de información que se debe enviar y almacenar en un cliente que tiene potencialmente limitada memoria y ancho de banda.

El tamaño máximo del elemento HTML "_VIEWSTATE" <hidden> se puede establecer a través de la MaxPageStateFieldLength propiedad o mediante el MaxPageStateFieldLength valor de configuración. Cuando se establece este valor y la longitud del elemento "_VIEWSTATE" superaría la longitud máxima, el contenido se divide en varios elementos "_VIEWSTATE".

Constructores

HiddenFieldPageStatePersister(Page)

Inicializa una nueva instancia de la clase HiddenFieldPageStatePersister.

Propiedades

ControlState	Obtiene o establece un objeto que representa los datos que los controles incluidos en el objeto Page actual utilizan para conservarse a lo largo de las distintas solicitudes HTTP al servidor Web. (Heredado de PageStatePersister)
Page	Obtiene o establece el objeto Page para el que se crea el mecanismo de persistencia del estado de vista. (Heredado de PageStatePersister)
StateFormatter	Obtiene un objeto IStateFormatter que se utiliza para serializar y deserializar la información de estado incluida en las propiedades ViewState y ControlState durante las llamadas a los métodos Save() y Load(). (Heredado de PageStatePersister)
ViewState	Obtiene o establece un objeto que representa los datos que los controles incluidos en el objeto Page actual utilizan para conservarse a lo largo de las distintas solicitudes HTTP al servidor Web. (Heredado de PageStatePersister)

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Load()	Deserializa y carga la información de estado guardada en un objeto HttpRequest cuando un objeto Page inicializa su jerarquía de controles.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Save()	Serializa cualquier estado de objeto incluido en la propiedad ViewState o ControlState y escribe el estado en la secuencia de respuesta.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Se aplica a

Share via