HiddenFieldPageStatePersister Classe

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Stocke l'état d'affichage de la page ASP.NET sur le client Web dans un élément HTML masqué.

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

Héritage: Object

PageStatePersister
HiddenFieldPageStatePersister

Exemples

L’exemple de code suivant montre comment lier un ListBox contrôle à des données d’une base de données avec un SqlDataSource contrôle.

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

Lorsque l’exemple de page est consulté, tout état d’affichage est stocké par la HiddenFieldPageStatePersister classe dans un <hidden> élément HTML nommé « __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>

Remarques

ASP.NET pages peuvent stocker Page l’état entre la requête et la réponse HTTP sans état requises pour traiter et traiter n’importe quelle page Web. Cet état est appelé « état d’affichage ». Le mécanisme par défaut utilisé pour stocker l’état d’affichage d’une page et de ses contrôles se trouve dans un ou plusieurs <hidden> champs HTML inclus dans la page qui est servi à un client à partir d’un serveur Web. La Page classe peut utiliser la HiddenFieldPageStatePersister classe pour effectuer ce travail. HiddenFieldPageStatePersister implémente les Save méthodes et Load de la PageStatePersister classe afin que puisse stocker l’état Page dans un <hidden> élément HTML nommé « __VIEWSTATE » sur un client Web. Lorsque le client demande la même page du serveur Web (une publication), l’élément <hidden> est analysé et converti en informations d’état par ASP.NET.

Si l’instance Page demandée a une classe associée PageAdapter , elle récupère l’objet PageStatePersister de cet adaptateur à l’aide de la GetStatePersister méthode . Les adaptateurs peuvent remplacer la GetStatePersister méthode pour retourner un objet qui stocke l’état PageStatePersister de la page et du contrôle d’une manière que prend en charge un client spécifique. Par exemple, la classe stocke l’état SessionPageStatePersister de la page et des contrôles sur le serveur Web, au lieu du client, pour réduire la quantité d’informations qui doivent être envoyées et stockées sur un client qui a potentiellement une mémoire et une bande passante limitées.

La taille maximale de l’élément HTML « _VIEWSTATE » <hidden> peut être définie par le biais de la MaxPageStateFieldLength propriété ou du paramètre de MaxPageStateFieldLength configuration. Lorsque cette valeur est définie et que la longueur de l’élément « _VIEWSTATE » dépasse la longueur maximale, le contenu est divisé en plusieurs éléments « _VIEWSTATE ».

Constructeurs

HiddenFieldPageStatePersister(Page)

Initialise une nouvelle instance de la classe HiddenFieldPageStatePersister.

Propriétés

ControlState	Obtient ou définit un objet qui représente les données que les contrôles contenus dans l'objet Page actuel utilisent pour la persistance à travers des requêtes HTTP au serveur Web. (Hérité de PageStatePersister)
Page	Obtient ou définit l'objet Page pour lequel le mécanisme de persistance de l'état d'affichage est créé. (Hérité de PageStatePersister)
StateFormatter	Obtient un objet IStateFormatter qui est utilisé pour sérialiser et désérialiser les informations d'état contenues dans les propriétés ViewState et ControlState lors de l'appel des méthodes Save() et Load(). (Hérité de PageStatePersister)
ViewState	Obtient ou définit un objet qui représente les données que les contrôles contenus dans l'objet Page actuel utilisent pour la persistance à travers des requêtes HTTP au serveur Web. (Hérité de PageStatePersister)

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Load()	Désérialise et charge des informations d'état persistant d'un objet HttpRequest lorsqu'un objet Page initialise sa hiérarchie de contrôle.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Save()	Sérialise tout état d'objet contenu dans le ViewState ou la propriété ControlState et écrit l'état dans le flux de réponse.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à