PageStatePersister Klasa

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Udostępnia podstawowe funkcje dla 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 dostarczana do aktywowania StreamPageStatePersister aplikacji ASP.NET. Na koniec udostępniono 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ę zwracającą PageAdapter wystąpienie klasy StreamPageStatePersister, która jest używana do utrwalania stanu wyświetlania i sterowania dla strony sieci Web ASP.NET.

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 w zestawie, 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 ustawień sterowania oraz danych, które sprawiają, że strona i kontrolki są wyświetlane tak samo, jak w przypadku, gdy użytkownik widział i wchodził w interakcje w ostatniej rundzie na serwerze. Istnieje kilka mechanizmów przechowywania stanu widoku między kolejnymi żądaniami na tej samej stronie. Klasa abstrakcyjna PageStatePersister reprezentuje klasę bazową dla tych mechanizmów przechowywania informacji o stanie.

Domyślnym mechanizmem trwałości stanu widoku w ASP.NET jest utrzymanie informacji o stanie jako ciąg zakodowany w formacie Base64 w ukrytym elemencie HTML (element z type atrybutem ustawionym na "hidden") 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 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żna 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ę poprawnie. Aby uzyskać więcej informacji na temat zarządzania stanem strony i stanu widoku, zobacz ASP.NET State Management Overview (Omówienie zarządzania stanami).

Jeśli piszesz kontrolki, możesz przechowywać informacje o stanie 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ą utracone, gdy stan widoku jest wyłączony przez dewelopera strony. Aby temu zapobiec, w ASP.NET wersji 2.0 można przechowywać informacje o stanie krytycznym w osobnym 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 kontrolki wymaga, aby kontrolka zastępowała LoadControlState metody i SaveControlState oraz że kontrolka ma być zarejestrowana w celu przechowywania informacji o stanie kontroli za każdym razem, gdy kontrolka jest inicjowana. Możesz zarejestrować kontrolkę, aby użyć stanu kontrolki, przesłaniając metodę OnInit i wywołując metodę RegisterRequiresControlState . Aby uzyskać więcej informacji na temat używania właściwości i stanu kontroli podczas ViewState opracowywania kontrolek, zobacz Tworzenie niestandardowych kontrolek serwera ASP.NET.

Aby zachować stan widoku na klientach, którzy nie mogą obsługiwać istniejących mechanizmów trwałości stanu widoku, można rozszerzyć PageStatePersister klasę, aby wprowadzić własne metody trwałości stanu widoku i można użyć kart stron do skonfigurowania aplikacji ASP.NET do korzystania z 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ć Load metodę, aby ją wyodrębnić. Jeśli musisz serializować stan widoku i stan kontrolki w ciągu, możesz użyć IStateFormatter obiektu, do którego uzyskuje się dostęp przy użyciu 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ść w celu podania własnego mechanizmu 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 używany do serializacji i deserializacji informacji o stanie zawartych w właściwościach ViewState i podczas wywołań metod Save() i ControlStateLoad().
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 bieżące wystąpienie. (Odziedziczone po Object)
Load()	Przesłonięta przez klasy pochodne w celu deserializacji i załadowania utrwalanych informacji o stanie, gdy Page obiekt inicjuje jego hierarchię sterowania.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Save()	Przesłonięta przez klasy pochodne w celu serializacji utrwalonego stanu informacji o stanie po Page rozładowaniu obiektu z pamięci.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• ObjectStateFormatter
• LosFormatter
• Pair