PageStatePersister Třída

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Poskytuje základní funkce pro mechanismy trvalosti stavu zobrazení ASP.NET.

public ref class PageStatePersister abstract

public abstract class PageStatePersister

type PageStatePersister = class

Public MustInherit Class PageStatePersister

Dědičnost

Object

PageStatePersister

Odvozené

System.Web.UI.HiddenFieldPageStatePersister

System.Web.UI.SessionPageStatePersister

Příklady

Následující příklad kódu ukazuje, jak vytvořit PageStatePersister objekt, který ukládá zobrazení a řízení stav na webovém serveru. Ukazuje StreamPageStatePersister , jak přepsat Load metody a Save k extrakci a uložení informací o stavu zobrazení. Vzhledem k tomu, že mechanismy trvalosti stavu souvisejí s adaptivním vykreslováním a funkcemi klienta, MyPageAdapter je třída k dispozici k aktivaci StreamPageStatePersister pro ASP.NET aplikaci. Nakonec je k dispozici soubor funkcí prohlížeče (.browser), který povolí MyPageAdapter adaptér pro konkrétní třídu klientů (v tomto případě výchozí webový prohlížeč).

namespace Samples.AspNet.CS
{

    using System;
    using System.IO;
    using System.Security.Permissions;
    using System.Web;
    using System.Web.UI;

    //
    // The StreamPageStatePersister is an example view state
    // persistence mechanism that persists view and control
    // state on the Web server.
    //
    [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
    public class StreamPageStatePersister : PageStatePersister
    {

        public StreamPageStatePersister(Page page)
            : base(page)
        {
        }
        //
        // Load ViewState and ControlState.
        //
        public override void Load()
        {
            Stream stateStream = GetSecureStream();

            // Read the state string, using the StateFormatter.
            StreamReader reader = new StreamReader(stateStream);

            IStateFormatter formatter = this.StateFormatter;
            string fileContents = reader.ReadToEnd();

            // Deserilize returns the Pair object that is serialized in
            // the Save method.
            Pair statePair = (Pair)formatter.Deserialize(fileContents);

            ViewState = statePair.First;
            ControlState = statePair.Second;
            reader.Close();
            stateStream.Close();
        }
        //
        // Persist any ViewState and ControlState.
        //
        public override void Save()
        {

            if (ViewState != null || ControlState != null)
            {
                if (Page.Session != null)
                {
                    Stream stateStream = GetSecureStream();

                    StreamWriter writer = new StreamWriter(stateStream);

                    IStateFormatter formatter = this.StateFormatter;
                    Pair statePair = new Pair(ViewState, ControlState);

                    // Serialize the statePair object to a string.
                    string serializedState = formatter.Serialize(statePair);

                    writer.Write(serializedState);
                    writer.Close();
                    stateStream.Close();
                }
                else
                {
                    throw new InvalidOperationException("Session needed for StreamPageStatePersister.");
                }
            }
        }
        // Return a secure Stream for your environment.
        private Stream GetSecureStream()
        {
            // You must provide the implementation to build
            // a secure Stream for your environment.
            return null;
        }
    }
}

Imports System.IO
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI

Namespace Samples.AspNet.VB

    ' The StreamPageStatePersister is an example view state
    ' persistence mechanism that persists view and control
    ' state on the Web server.
    '
    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class StreamPageStatePersister
        Inherits PageStatePersister


        Public Sub New(ByVal page As Page)
            MyBase.New(page)
        End Sub

        '
        ' Load ViewState and ControlState.
        '
        Public Overrides Sub Load()

            Dim stateStream As Stream
            stateStream = GetSecureStream()

            ' Read the state string, using the StateFormatter.
            Dim reader As New StreamReader(stateStream)

            Dim serializedStatePair As String
            serializedStatePair = reader.ReadToEnd
            Dim statePair As Pair

            Dim formatter As IStateFormatter
            formatter = Me.StateFormatter

            ' Deserilize returns the Pair object that is serialized in
            ' the Save method.      
            statePair = CType(formatter.Deserialize(serializedStatePair), Pair)

            ViewState = statePair.First
            ControlState = statePair.Second
            reader.Close()
            stateStream.Close()
        End Sub

        '
        ' Persist any ViewState and ControlState.
        '
        Public Overrides Sub Save()

            If Not (ViewState Is Nothing) OrElse Not (ControlState Is Nothing) Then
                If Not (Page.Session Is Nothing) Then

                    Dim stateStream As Stream
                    stateStream = GetSecureStream()

                    ' Write a state string, using the StateFormatter.
                    Dim writer As New StreamWriter(stateStream)

                    Dim formatter As IStateFormatter
                    formatter = Me.StateFormatter

                    Dim statePair As New Pair(ViewState, ControlState)

                    Dim serializedState As String
                    serializedState = formatter.Serialize(statePair)

                    writer.Write(serializedState)
                    writer.Close()
                    stateStream.Close()
                Else
                    Throw New InvalidOperationException("Session needed for StreamPageStatePersister.")
                End If
            End If
        End Sub
        ' Return a secure Stream for your environment.
        Private Function GetSecureStream() As Stream
            ' You must provide the implementation to build
            ' a secure Stream for your environment.
            Return Nothing
        End Function
    End Class
End Namespace

Následující příklad kódu ukazuje, jak vytvořit PageAdapter třídu, která vrací instanci StreamPageStatePersister, která se používá k zachování zobrazení a řízení stavu ASP.NET webové stránky.

namespace Samples.AspNet.CS {

    using System.Security.Permissions;
    using System.Web;
    using System.Web.UI;

    [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
    public class MyPageAdapter : System.Web.UI.Adapters.PageAdapter {

        public override PageStatePersister GetStatePersister() {
            return new Samples.AspNet.CS.StreamPageStatePersister(Page);
        }
    }
}

Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI

Namespace Samples.AspNet.VB

    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
    Public Class MyPageAdapter
       Inherits System.Web.UI.Adapters.PageAdapter


       Public Overrides Function GetStatePersister() As PageStatePersister
          Return New Samples.AspNet.VB.StreamPageStatePersister(Page)
       End Function 'GetStatePersister

    End Class

End Namespace

Zkompilujte tyto dvě třídy do sestavení, které můžete použít ke spuštění ukázky pomocí následujícího příkazového řádku kompilátoru. Ujistěte se, že se kompilované sestavení nachází v adresáři \Bin pod kořenem aplikace ASP.NET.

// C:\>csc /t:library /out:C:\inetpub\wwwroot\bin\Samples.AspNet.CS.dll MyPageAdapter.cs TextFilePageStatePersister.cs
//
// C:\>

' C:\>vbc /t:library /out:C:\inetpub\wwwroot\bin\Samples.AspNet.VB.dll MyPageAdapter.vb TextFilePageStatePersister.vb
'

Pokud chcete adaptér povolit MyPageAdapter , musíte vytvořit adresář s názvem Prohlížeče pod kořenem aplikace ASP.NET a zahrnout soubor .browser s informacemi o konfiguraci. Element <refid> v konfiguračním souboru označuje, že konfigurace přepíše hodnoty zadané pro výchozí prohlížeč v konfiguračním souboru Default.browser. V tomto příkladu MyPageAdapter se používá pro ASP.NET webových stránek (kde se obvykle nepoužívá žádný adaptér).

<browsers>  
    <browser refid="Default" >  
        <controlAdapters>  
            <adapter   
                controlType="System.Web.UI.Page"                              
                adapterType="Samples.AspNet.CS.MyPageAdapter" />  
        </controlAdapters>  
    </browser>  
</browsers>  

Poznámky

Požadavky a odpovědi HTTP jsou ze své podstaty bezstavové. Aby bylo možné udržovat informace o stavu mezi požadavky HTTP, můžou stránky ASP.NET serveru ukládat Page stav. Tento stav, označovaný jako stav zobrazení, se skládá z nastavení stránky a ovládacích prvků a dat, díky kterým se stránka a ovládací prvky zobrazují, jako by byly stejné jako ty, které uživatel viděl a s nimi pracoval při poslední cestě na server. Existuje několik mechanismů pro ukládání stavu zobrazení mezi po sobě jdoucími požadavky na stejnou stránku. Abstraktní PageStatePersister třída představuje základní třídu pro tyto mechanismy ukládání informací o stavu.

Výchozím mechanismem trvalosti zobrazení stavu v ASP.NET je udržovat informace o stavu jako řetězec kódovaný jako Base64 ve skrytém elementu HTML (elementu s atributem type nastaveným na "hidden") na stránce. Stránka ASP.NET používá HiddenFieldPageStatePersister objekt k provedení této práce pomocí IStateFormatter instance k serializaci a deserializaci informací o stavu objektu. Případně můžete uložit stav zobrazení stránek v objektu Session na serveru pomocí SessionPageStatePersister třídy pro mobilní klienty s omezenou šířkou pásma a prostředky. V některých případech můžete trvalost stavu zobrazení úplně zakázat. Pokud to uděláte, výsledkem je, že se někdy stránky a ovládací prvky, které spoléhají na trvalost stavu, nechovají správně. Další informace o správě stavu stránky a zobrazení stavu najdete v tématu Přehled správy stavu ASP.NET.

Pokud píšete ovládací prvky, můžete ukládat informace o stavu ovládacích prvků ve slovníku ViewState , což je StateBag objekt. Vývojář načte stav ovládacího prvku prostřednictvím ControlState vlastnosti . Přiřadíte klíče a hodnoty vlastnosti ViewState a Page objekt serializuje informace o stavu mezi požadavky. Pokud chcete v ovládacím prvku provádět vlastní zpracování stavu, přepište LoadViewState metody a SaveViewState . Všechny informace o stavu uložené v tomto slovníku budou ztraceny, když vývojář stránky zakáže stav zobrazení. Pokud chcete tento problém zmírnit, můžete v ASP.NET verze 2.0 ukládat důležité informace o stavu do samostatného objektu, kterému se říká stav řízení. Objekt stavu ovládacího prvku není ovlivněn, pokud je stav zobrazení zakázán vývojářem stránky. Ukládání informací o stavu v objektu stavu ovládacího prvku vyžaduje, aby ovládací prvek přepsal LoadControlState metody a SaveControlState a aby byl ovládací prvek zaregistrován tak, aby při každé inicializaci ovládacího prvku ukládal informace o stavu ovládacího prvku. Můžete zaregistrovat ovládací prvek pro použití stavu řízení přepsáním OnInit metody a voláním RegisterRequiresControlState metody. Další informace o použití ViewState vlastnosti a stavu ovládacího prvku při vývoji ovládacích prvků najdete v tématu Vývoj vlastních ASP.NET serverových ovládacích prvků.

Chcete-li zachovat stav zobrazení na klientech, kteří nepodporují existující mechanismy trvalosti stavu zobrazení, můžete rozšířit PageStatePersister třídu o vlastní metody trvalosti stavu zobrazení a pomocí adaptérů stránky nakonfigurovat aplikaci ASP.NET tak, aby používala různé mechanismy trvalosti zobrazení na základě typu klienta, kterému je stránka obsluhována. Třídy, které jsou odvozeny z PageStatePersister třídy, musí přepsat abstraktní Save metodu, aby se uložil stav zobrazení a řízení na médiu trvalosti, a přepsat metodu Load k jeho extrahování. Pokud potřebujete serializovat stav zobrazení a stav řízení na řetězec, můžete použít IStateFormatter objekt, ke kterému se přistupuje pomocí StateFormatter vlastnosti . Efektivně serializuje a deserializuje informace o stavu objektu do řetězce kódování Base64. Můžete také přepsat StateFormatter vlastnost pro zadání vlastního mechanismu serializace stavu objektu.

Konstruktory

PageStatePersister(Page)

Inicializuje novou instanci PageStatePersister 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í http požadavky na webový server.
Page	Získá nebo nastaví Page objekt, pro který je vytvořen mechanismus trvalosti stavu zobrazení.
StateFormatter	Získá IStateFormatter objekt, který se používá k serializaci a deserializovat informace o stavu obsažené ve ViewState vlastnostech a ControlState během volání Save() metod a Load() .
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í http požadavky na webový server.

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()	Získá aktuální Type instanci. (Zděděno od Object)
Load()	Přepsáno odvozenými třídami deserializovat a načíst trvalé informace o stavu, když Page objekt inicializuje svou řídicí hierarchii.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Save()	Přepsáno odvozenými třídami serializovat trvalé informace o stavu při uvolnění objektu Page z paměti.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• ObjectStateFormatter
• LosFormatter
• Pair