HiddenFieldPageStatePersister Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Uloží ASP.NET stav zobrazení stránky webového klienta do skrytého elementu HTML.
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
- Dědičnost
Příklady
Následující příklad kódu ukazuje, jak vytvořit vazbu ListBox ovládacího prvku na data v databázi pomocí SqlDataSource ovládacího prvku.
<%@ 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>
Při zobrazení ukázkové stránky jsou všechny stavy zobrazení uloženy HiddenFieldPageStatePersister třídou v elementu <hidden>
HTML s názvem "__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>
Poznámky
ASP.NET stránky můžou ukládat Page stav mezi vlastními bezstavovými požadavky HTTP a odpověďmi potřebnými ke zpracování a obsluhě jakékoli webové stránky. Tento stav se nazývá "stav zobrazení". Výchozí mechanismus používaný k ukládání stavu zobrazení stránky a jejích ovládacích prvků je v jednom nebo více <hidden>
polích HTML zahrnutých na stránce, která je obsluhována klientovi z webového serveru. Třída Page může k této práci použít HiddenFieldPageStatePersister třídu .
HiddenFieldPageStatePersisterimplementuje Save metody PageStatePersister a Load třídy tak, aby Page mohly ukládat stav v elementu <hidden>
HTML s názvem "__VIEWSTATE" na webovém klientovi. Když klient požaduje stejnou stránku z webového serveru (zpětné), <hidden>
je prvek analyzován a převeden na informace o stavu ASP.NET.
Page Pokud má požadovaná instance přidruženou PageAdapter třídu, načte PageStatePersister objekt z tohoto adaptéru GetStatePersister pomocí metody . Adaptéry můžou přepsat metodu GetStatePersister tak, aby vrátila PageStatePersister objekt, který ukládá stav stránky a ovládacího prvku nějakým způsobem, který konkrétní klient podporuje. Třída například SessionPageStatePersister ukládá stav stránky a ovládacích prvků na webový server místo na klientovi, aby se snížilo množství informací, které musí být odeslány a uloženy v klientovi, který má potenciálně omezenou paměť a šířku pásma.
Maximální velikost elementu HTML "_VIEWSTATE" <hidden>
lze nastavit prostřednictvím MaxPageStateFieldLength vlastnosti nebo MaxPageStateFieldLength nastavení konfigurace. Pokud je tato hodnota nastavena a délka elementu "_VIEWSTATE" by překročila maximální délku, je obsah rozdělen na více prvků "_VIEWSTATE".
Konstruktory
HiddenFieldPageStatePersister(Page) |
Inicializuje novou instanci HiddenFieldPageStatePersister třídy . |
Vlastnosti
ControlState |
Získá nebo nastaví objekt, který představuje data, která ovládací prvky obsažené v aktuálním Page objektu použít k zachování v rámci požadavků HTTP na webový server. (Zděděno od PageStatePersister) |
Page |
Získá nebo nastaví Page objekt, pro který je vytvořen mechanismus trvalosti stavu zobrazení. (Zděděno od PageStatePersister) |
StateFormatter |
IStateFormatter Získá objekt, který slouží k serializaci a deserializaci informací o stavu obsažených ve ViewState vlastnostech a ControlState během volání Save() metod a Load() . (Zděděno od PageStatePersister) |
ViewState |
Získá nebo nastaví objekt, který představuje data, která ovládací prvky obsažené v aktuálním Page objektu použít k zachování v rámci požadavků HTTP na webový server. (Zděděno od PageStatePersister) |
Metody
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
Load() |
Deserializuje a načte trvalé informace o stavu z objektu HttpRequest , když Page objekt inicializuje svou řídicí hierarchii. |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
Save() |
Serializuje jakýkoli stav objektu ViewState obsažený ve vlastnosti nebo ControlState a zapíše stav do streamu odpovědi. |
ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |