HiddenFieldPageStatePersister Klasse

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Speichert den ASP.NET-Seitenansichtszustand in einem ausgeblendeten HTML-Element auf dem Webclient.

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

Vererbung: Object

PageStatePersister
HiddenFieldPageStatePersister

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein Steuerelement mit einem ListBox Steuerelement an Daten in einer SqlDataSource Datenbank gebunden wird.

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

Wenn die Beispielseite angezeigt wird, wird jeder Ansichtszustand von der HiddenFieldPageStatePersister -Klasse in einem <hidden> HTML-Element mit dem Namen "__VIEWSTATE" gespeichert.

<!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>

Hinweise

ASP.NET Seiten können den Zustand zwischen der inhärent zustandslosen HTTP-Anforderung und -Antwort speichern Page , die für die Verarbeitung und Bereitstellung jeder Webseite erforderlich ist. Dieser Zustand wird als "Ansichtszustand" bezeichnet. Der Standardmechanismus zum Speichern des Ansichtszustands für eine Seite und deren Steuerelemente befindet sich in einem oder <hidden> mehreren HTML-Feldern, die auf der Seite enthalten sind, die von einem Webserver an einen Client bereitgestellt wird. Die Page -Klasse kann die HiddenFieldPageStatePersister -Klasse verwenden, um diese Arbeit zu erledigen. HiddenFieldPageStatePersister implementiert die Save Methoden und Load der PageStatePersister -Klasse, sodass der Page Zustand in einem <hidden> HTML-Element namens "__VIEWSTATE" auf einem Webclient gespeichert werden kann. Wenn der Client dieselbe Seite vom Webserver anfordert (ein Postback), wird das <hidden> Element analysiert und von ASP.NET in Zustandsinformationen konvertiert.

Wenn die Page angeforderte Instanz über eine zugeordnete PageAdapter Klasse verfügt, ruft sie das -Objekt mithilfe der PageStatePersister GetStatePersister -Methode von diesem Adapter ab. Adapter können die GetStatePersister -Methode überschreiben, um ein PageStatePersister Objekt zurückzugeben, das den Seiten- und Steuerelementstatus auf eine Weise speichert, die von einem bestimmten Client unterstützt wird. Beispielsweise speichert die Klasse den SessionPageStatePersister Zustand der Seite und Steuerelemente auf dem Webserver anstelle des Clients, um die Menge der Informationen zu verringern, die auf einem Client gesendet und gespeichert werden müssen, der möglicherweise über begrenzten Arbeitsspeicher und Bandbreite verfügt.

Die maximale Größe des HTML-Elements "_VIEWSTATE" <hidden> kann über die MaxPageStateFieldLength -Eigenschaft oder über die MaxPageStateFieldLength Konfigurationseinstellung festgelegt werden. Wenn dieser Wert festgelegt ist und die Länge des "_VIEWSTATE"-Elements die maximale Länge überschreitet, wird der Inhalt in mehrere "_VIEWSTATE"-Elemente unterteilt.

Konstruktoren

HiddenFieldPageStatePersister(Page)

Initialisiert eine neue Instanz der HiddenFieldPageStatePersister-Klasse.

Eigenschaften

ControlState	Ruft ein Objekt ab, das die Daten darstellt, die Steuerelemente, die sich im aktuellen Page-Objekt befinden, über HTTP-Anforderungen an den Webserver hinweg beibehalten, oder legt dieses fest. (Geerbt von PageStatePersister)
Page	Ruft das Page-Objekt fest, für das der Dauerhaftigkeitsmechanismus für den Ansichtszustand erstellt wird, oder legt dieses fest. (Geerbt von PageStatePersister)
StateFormatter	Ruft ein IStateFormatter-Objekt ab, das bei Aufrufen der ViewState-Methode und der ControlState-Methode zum Serialisieren und Deserialisieren der in der Save()-Eigenschaft und der Load()-Eigenschaft befindlichen Zustandsinformationen verwendet wird. (Geerbt von PageStatePersister)
ViewState	Ruft ein Objekt ab, das die Daten darstellt, die Steuerelemente, die sich im aktuellen Page-Objekt befinden, über HTTP-Anforderungen an den Webserver hinweg beibehalten, oder legt dieses fest. (Geerbt von PageStatePersister)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Load()	Deserialisiert und lädt beibehaltene Zustandsinformationen von einem HttpRequest-Objekt, wenn ein Page-Objekt seine Steuerelementhierarchie initialisiert.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Save()	Serialisiert einen beliebigen Objektzustand, der in der ViewState-Eigenschaft oder der ControlState-Eigenschaft enthalten ist, und schreibt den Zustand in den Antwortstream.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für: