HiddenFieldPageStatePersister Classe

Definição

Espaço de Nomes:
System.Web.UI
Assemblagem:
System.Web.dll

Armazena o estado da vista de página ASP.NET no cliente Web num 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 seguinte demonstra como associar um ListBox controlo a dados numa base de dados com um SqlDataSource controlo.

<%@ 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 é visualizada, qualquer estado de vista é armazenado pela HiddenFieldPageStatePersister classe num <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>

Observações

ASP.NET páginas podem armazenar o estado Page entre o pedido HTTP inerentemente sem estado e a resposta necessária para processar e servir qualquer página Web. Este estado chama-se "estado de visualização". O mecanismo padrão usado para armazenar o estado da vista de uma página e dos seus controlos está num ou mais <hidden> campos HTML incluídos na página que é servido a um cliente a partir de um servidor Web. A Page turma pode usar a HiddenFieldPageStatePersister disciplina para realizar este trabalho. HiddenFieldPageStatePersister implementa os Save métodos e Load da PageStatePersister classe para que possam Page armazenar o estado num <hidden> elemento HTML chamado "__VIEWSTATE" num cliente Web. Quando o cliente solicita a mesma página ao servidor Web (um postback), o elemento <hidden> é analisado e convertido em informação de estado por ASP.NET.

Se a Page instância solicitada tiver uma classe associada PageAdapter , recupera o PageStatePersister objeto desse adaptador usando o GetStatePersister método. Os adaptadores podem sobrepor o GetStatePersister método para devolver um PageStatePersister objeto que armazena o estado da página e do controlo de alguma forma que um cliente específico suporte. Por exemplo, a SessionPageStatePersister classe armazena o estado da página e dos controlos no servidor Web, em vez do cliente, para diminuir a quantidade de informação que deve ser enviada e armazenada num cliente que tem potencialmente memória e largura de banda limitadas.

O tamanho máximo do elemento HTML "_VIEWSTATE" <hidden> pode ser definido através da MaxPageStateFieldLength propriedade ou através da MaxPageStateFieldLength configuração de configuração. Quando este valor é definido e o comprimento do elemento "_VIEWSTATE" excede o comprimento máximo, o conteúdo é dividido em múltiplos elementos "_VIEWSTATE".

Construtores

Name Description
HiddenFieldPageStatePersister(Page)

Inicializa uma nova instância da HiddenFieldPageStatePersister classe.

Propriedades

Name Description
ControlState

Obtém ou define um objeto que representa os dados que controlam contidos pelo objeto atual Page para persistir através dos pedidos HTTP para o servidor Web.

(Herdado de PageStatePersister)
Page

Obtém ou define o Page objeto para o qual o mecanismo de persistência do estado de vista foi criado.

(Herdado de PageStatePersister)
StateFormatter

Obtém um IStateFormatter objeto que é usado para serializar e desserializar a informação de estado contida nas ViewState propriedades e ControlState durante chamadas aos Save() métodos e Load() .

(Herdado de PageStatePersister)
ViewState

Obtém ou define um objeto que representa os dados que controlam contidos pelo objeto atual Page para persistir através dos pedidos HTTP para o servidor Web.

(Herdado de PageStatePersister)

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Load()

Desserializa e carrega a informação de estado persistente de um HttpRequest objeto quando este Page inicializa a sua hierarquia de controlo.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Save()

Serializa qualquer estado de objeto contido na ViewState propriedade ou ControlState e escreve esse estado no fluxo de resposta.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também