PageStatePersister Klasa

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Udostępnia podstawowe funkcje mechanizmów trwałości stanu ASP.NET widoku.

public ref class PageStatePersister abstract

public abstract class PageStatePersister

type PageStatePersister = class

Public MustInherit Class PageStatePersister

Dziedziczenie

Object

PageStatePersister

Pochodne

System.Web.UI.HiddenFieldPageStatePersister

System.Web.UI.SessionPageStatePersister

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć PageStatePersister obiekt, który zapisuje stan wyświetlania i sterowania na serwerze sieci Web. W tym StreamPageStatePersister artykule pokazano, jak zastąpić Load metody i Save w celu wyodrębnienia i zapisania informacji o stanie widoku. Ponieważ mechanizmy trwałości stanu są związane z adaptacyjnym renderowaniem i możliwościami klienta, MyPageAdapter klasa jest udostępniana w celu aktywowania StreamPageStatePersister obiektu dla aplikacji ASP.NET. Na koniec udostępniany jest plik możliwości przeglądarki (.browser), aby włączyć kartę MyPageAdapter dla określonej klasy klientów (w tym przypadku domyślna przeglądarka sieci Web).

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

W poniższym przykładzie kodu pokazano, jak utworzyć klasę PageAdapter zwracającą wystąpienie StreamPageStatePersisterklasy , która jest używana do utrwalania stanu wyświetlania i sterowania dla ASP.NET strony sieci Web.

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

Skompiluj te dwie klasy do zestawu, którego można użyć do uruchomienia przykładu przy użyciu następującego wiersza polecenia kompilatora. Upewnij się, że skompilowany zestaw znajduje się w katalogu \Bin poniżej katalogu głównego aplikacji 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
'

Na koniec, aby włączyć kartęMyPageAdapter, należy utworzyć katalog o nazwie Przeglądarki poniżej katalogu głównego aplikacji ASP.NET i dołączyć plik przeglądarki z informacjami o konfiguracji. Element <refid> w pliku konfiguracji wskazuje, że konfiguracja zastępuje wartości określone dla domyślnej przeglądarki w pliku konfiguracji Default.browser. W tym przykładzie MyPageAdapter jest używany do ASP.NET stron sieci Web (gdzie zwykle nie jest używana żadna karta).

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

Uwagi

Żądania i odpowiedzi HTTP są z natury bezstanowe. Aby zachować informacje o stanie między żądaniami HTTP, ASP.NET strony serwera mogą przechowywać Page stan. Ten stan, nazywany stanem widoku, składa się z ustawień strony i kontrolki oraz danych, które sprawiają, że strona i kontrolki są wyświetlane tak, jakby były takie same, z którymi użytkownik widział i wchodził w interakcję podczas ostatniej rundy na serwerze. Istnieje kilka mechanizmów do przechowywania stanu widoku między kolejnymi żądaniami do tej samej strony. Klasa abstrakcyjna PageStatePersister reprezentuje klasę bazową dla tych mechanizmów przechowywania informacji o stanie.

Domyślny mechanizm trwałości stanu widoku w ASP.NET polega na utrzymaniu informacji o stanie jako ciąg zakodowany w formacie Base64 w ukrytym elemencie HTML (element z type atrybutem ustawionym na "hidden"wartość ) na stronie. Strona ASP.NET używa HiddenFieldPageStatePersister obiektu do wykonania tej pracy, używając IStateFormatter wystąpienia do serializacji i deserializacji informacji o stanie obiektu. Alternatywnie można przechowywać stan widoku dla stron w Session obiekcie na serwerze przy użyciu SessionPageStatePersister klasy dla klientów mobilnych z ograniczoną przepustowością i zasobami. W niektórych przypadkach możesz całkowicie wyłączyć trwałość stanu widoku. W takim przypadku wynikiem jest to, że czasami strony i kontrolki, które opierają się na trwałości stanu, nie zachowują się prawidłowo. Aby uzyskać więcej informacji na temat zarządzania stanem strony i stanu widoku, zobacz omówienie zarządzania stanem ASP.NET.

Jeśli piszesz kontrolki, możesz przechowywać informacje o stanie dla kontrolek w słowniku ViewState , który jest obiektem StateBag . Deweloper pobiera stan kontroli za pośrednictwem ControlState właściwości . Klucze i wartości są przypisywane do ViewState właściwości, a Page obiekt serializuje informacje o stanie między żądaniami. Aby wykonać niestandardową obsługę stanu w kontrolce, zastąpij LoadViewState metody i SaveViewState . Wszelkie informacje o stanie przechowywane w tym słowniku są tracone, gdy stan widoku jest wyłączony przez dewelopera strony. Aby temu zapobiec, w ASP.NET w wersji 2.0 można przechowywać informacje o stanie krytycznym w oddzielnym obiekcie nazywanym stanem sterowania. Nie ma to wpływu na obiekt stanu kontroli, gdy stan widoku jest wyłączony przez dewelopera strony. Przechowywanie informacji o stanie w obiekcie stanu kontroli wymaga, aby kontrolka zastępowała LoadControlState metody i SaveControlState oraz że kontrolka ma być zarejestrowana do przechowywania informacji o stanie stanu w stanie kontroli za każdym razem, gdy kontrolka jest inicjowana. Możesz zarejestrować kontrolkę, aby używać stanu kontrolki, przesłaniając metodę OnInit i wywołując metodę RegisterRequiresControlState . Aby uzyskać więcej informacji na temat używania ViewState właściwości i stanu sterowania podczas opracowywania kontrolek, zobacz Artykuł Developing Custom ASP.NET Server Controls (Tworzenie niestandardowych kontrolek serwera ASP.NET).

Aby zachować stan wyświetlania na klientach, którzy nie mogą obsługiwać istniejących mechanizmów trwałości stanu widoku, można rozszerzyć PageStatePersister klasę w celu wprowadzenia własnych metod trwałości stanu widoku i można użyć kart strony do skonfigurowania aplikacji ASP.NET do używania różnych mechanizmów trwałości stanu widoku na podstawie typu klienta, do którego jest obsługiwana strona. Klasy pochodzące z PageStatePersister klasy muszą zastąpić metodę abstrakcyjną Save , aby przechowywać stan widoku i stan kontroli na nośniku trwałości, a następnie zastąpić metodę Load , aby ją wyodrębnić. Jeśli musisz serializować stan widoku i stan kontroli w ciągu, możesz użyć IStateFormatter obiektu, do którego uzyskuje się dostęp za pomocą StateFormatter właściwości . Efektywnie serializuje i deserializuje informacje o stanie obiektu do ciągu zakodowanego w formacie Base64. Można również zastąpić StateFormatter właściwość , aby dostarczyć własny mechanizm serializacji stanu obiektu.

Konstruktory

PageStatePersister(Page)

Inicjuje nowe wystąpienie klasy PageStatePersister.

Właściwości

ControlState	Pobiera lub ustawia obiekt, który reprezentuje dane, które steruje bieżącym Page obiektem używanym do utrwalania żądań HTTP na serwerze sieci Web.
Page	Pobiera lub ustawia Page obiekt, dla którego jest tworzony mechanizm trwałości stanu widoku.
StateFormatter	IStateFormatter Pobiera obiekt, który jest używany do serializacji i deserializacji informacji o stanie zawartych w ViewState właściwościach i podczas wywołań metod Save() i ControlState Load().
ViewState	Pobiera lub ustawia obiekt, który reprezentuje dane, które steruje bieżącym Page obiektem używanym do utrwalania żądań HTTP na serwerze sieci Web.

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
Load()	Zastępowane przez klasy pochodne do deserializacji i ładowania utrwalone informacje o stanie, gdy Page obiekt inicjuje jego hierarchię sterowania.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Save()	Zastępowane przez klasy pochodne w celu serializacji utrwalone informacje o stanie, gdy Page obiekt zostanie zwolniony z pamięci.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• ObjectStateFormatter
• LosFormatter
• Pair