HiddenFieldPageStatePersister Classe

Referência

Definição

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Armazena o estado de exibição de página ASP.NET no cliente da Web em um 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

Herança: Object

PageStatePersister
HiddenFieldPageStatePersister

Exemplos

O exemplo de código a seguir demonstra como associar um ListBox controle a dados em um banco de dados com um SqlDataSource controle.

<%@ 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>

Quando a página de exemplo é exibida, qualquer estado de exibição é armazenado pela HiddenFieldPageStatePersister classe em um <hidden> elemento HTML chamado "__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>

Comentários

ASP.NET páginas podem armazenar Page o estado entre a solicitação HTTP inerentemente sem estado e a resposta necessária para processar e atender a qualquer página da Web. Esse estado é chamado de "estado de exibição". O mecanismo padrão usado para armazenar o estado de exibição de uma página e seus controles está em um ou mais <hidden> campos HTML incluídos na página que é atendida a um cliente de um servidor Web. A Page classe pode usar a HiddenFieldPageStatePersister classe para fazer esse trabalho. HiddenFieldPageStatePersisterimplementa os métodos e Load os Save PageStatePersister métodos da classe para que o Page estado possa armazenar em um <hidden> elemento HTML chamado "__VIEWSTATE" em um cliente Web. Quando o cliente solicita a mesma página do servidor Web (um postback), o <hidden> elemento é analisado e convertido em informações de estado por ASP.NET.

Se a Page instância solicitada tiver uma classe associada PageAdapter , ela recuperará o PageStatePersister objeto desse adaptador usando o GetStatePersister método. Os adaptadores podem substituir o GetStatePersister método para retornar um PageStatePersister objeto que armazena o estado de página e controle de alguma forma que um cliente específico dá suporte. Por exemplo, a classe armazena o SessionPageStatePersister estado da página e dos controles no servidor Web, em vez do cliente, para diminuir a quantidade de informações que devem ser enviadas e armazenadas em um cliente que tenha memória e largura de banda potencialmente limitadas.

O tamanho máximo do elemento HTML "_VIEWSTATE" <hidden> pode ser definido por meio da MaxPageStateFieldLength propriedade ou por meio da MaxPageStateFieldLength configuração. Quando esse valor é definido e o comprimento do elemento "_VIEWSTATE" excede o comprimento máximo, o conteúdo é dividido em vários elementos "_VIEWSTATE".

Construtores

HiddenFieldPageStatePersister(Page)

Inicializa uma nova instância da classe HiddenFieldPageStatePersister.

Propriedades

ControlState	Obtém ou define um objeto que representa os dados que controla, contidos pelo objeto Page atual que usa para persistir em solicitações HTTP ao servidor Web. (Herdado de PageStatePersister)
Page	Obtém ou define o objeto Page para o qual o mecanismo de persistência de estado de exibição é criado. (Herdado de PageStatePersister)
StateFormatter	Obtém um objeto IStateFormatter que é usado para serializar e desserializar as informações de estado contidas nas propriedades ViewState e ControlState durante as chamadas aos métodos Save() e Load(). (Herdado de PageStatePersister)
ViewState	Obtém ou define um objeto que representa os dados que controla, contidos pelo objeto Page atual que usa para persistir em solicitações HTTP ao servidor Web. (Herdado de PageStatePersister)

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Load()	Desserializa e carrega informações de estado persistente de um objeto HttpRequest quando um objeto Page inicializa sua hierarquia de controle.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Save()	Serializa qualquer estado de objeto contido na propriedade ViewState ou ControlState e grava o estado no fluxo de resposta.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Aplica-se a