HiddenFieldPageStatePersister Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Archivia lo stato di visualizzazione di una pagina ASP.NET nel client Web all'interno di un elemento HTML nascosto.

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

Ereditarietà: Object

PageStatePersister
HiddenFieldPageStatePersister

Esempio

Nell'esempio di codice seguente viene illustrato come associare un ListBox controllo ai dati in un database con un SqlDataSource controllo.

<%@ 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 viene visualizzata la pagina di esempio, qualsiasi stato di visualizzazione viene archiviato dalla HiddenFieldPageStatePersister classe in un <hidden> elemento HTML denominato "__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>

Commenti

ASP.NET pagine possono archiviare Page lo stato tra la richiesta HTTP intrinsecamente senza stato e la risposta necessaria per elaborare e gestire qualsiasi pagina Web. Questo stato viene chiamato "stato di visualizzazione". Il meccanismo predefinito usato per archiviare lo stato di visualizzazione per una pagina e i relativi controlli si trovano in uno o più <hidden> campi HTML inclusi nella pagina servita a un client da un server Web. La Page classe può usare la HiddenFieldPageStatePersister classe per eseguire questa operazione. HiddenFieldPageStatePersisterimplementa i metodi e Load della PageStatePersister classe in modo da Page poter archiviare lo Save stato in un elemento HTML denominato "__VIEWSTATE" in un <hidden> client Web. Quando il client richiede la stessa pagina dal server Web (postback), l'elemento <hidden> viene analizzato e convertito in informazioni sullo stato da ASP.NET.

Se l'istanza Page richiesta ha una classe associata PageAdapter , recupera l'oggetto da questa scheda usando il PageStatePersister GetStatePersister metodo . Gli adattatori possono eseguire l'override del GetStatePersister metodo per restituire un oggetto che archivia lo stato di pagina e controllo in qualche modo supportato da un PageStatePersister client specifico. Ad esempio, la SessionPageStatePersister classe archivia lo stato della pagina e dei controlli sul server Web, anziché sul client, per ridurre la quantità di informazioni che devono essere inviate e archiviate in un client con memoria e larghezza di banda potenzialmente limitata.

Le dimensioni massime dell'elemento HTML "_VIEWSTATE" <hidden> possono essere impostate tramite la MaxPageStateFieldLength proprietà o tramite l'impostazione di MaxPageStateFieldLength configurazione. Quando questo valore viene impostato e la lunghezza dell'elemento "_VIEWSTATE" supera la lunghezza massima, il contenuto viene diviso in più elementi "_VIEWSTATE".

Costruttori

HiddenFieldPageStatePersister(Page)

Inizializza una nuova istanza della classe HiddenFieldPageStatePersister.

Proprietà

ControlState	Ottiene o imposta un oggetto che rappresenta i dati utilizzati dai controlli contenuti nell'oggetto Page corrente per la persistenza tra le richieste HTTP inviate al server Web. (Ereditato da PageStatePersister)
Page	Ottiene o imposta l'oggetto Page per il quale viene creato il meccanismo di persistenza dello stato di visualizzazione. (Ereditato da PageStatePersister)
StateFormatter	Ottiene un oggetto IStateFormatter utilizzato per serializzare e deserializzare le informazioni sullo stato contenute nelle proprietà ViewState e ControlState durante le chiamate dei metodi Save() e Load(). (Ereditato da PageStatePersister)
ViewState	Ottiene o imposta un oggetto che rappresenta i dati utilizzati dai controlli contenuti nell'oggetto Page corrente per la persistenza tra le richieste HTTP inviate al server Web. (Ereditato da PageStatePersister)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Load()	Deserializza e carica informazioni persistenti sullo stato da un oggetto HttpRequest quando un oggetto Page inizializza la relativa gerarchia dei controlli.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Save()	Serializza lo stato di qualsiasi oggetto specificato nella proprietà ViewState o ControlState e scrive lo stato nel flusso di risposta.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a