IStateFormatter Interfaccia

Definizione

Spazio dei nomi:

System.Web.UI

Assembly:

System.Web.dll

Definisce i metodi implementati da un tipo per serializzare e deserializzare il grafico di un oggetto.

public interface class IStateFormatter

public interface IStateFormatter

type IStateFormatter = interface

Public Interface IStateFormatter

Derivato

System.Web.UI.ObjectStateFormatter

Esempio

Nell'esempio di codice seguente viene illustrato come creare un PageStatePersister oggetto che salva lo stato di visualizzazione e controllo in un flusso nel server Web. La StreamPageStatePersister classe illustra come eseguire l'override dei Load metodi e Save per estrarre e salvare le informazioni sullo stato della pagina. Questi metodi usano l'interfaccia IStateFormatter ereditata dalla PageStatePersister classe per serializzare e deserializzare lo stato di visualizzazione. Questo esempio di codice fa parte di un esempio più ampio fornito per la PageStatePersister classe .

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

Commenti

L'interfaccia IStateFormatter definisce i metodi che un tipo può implementare per serializzare e deserializzare lo stato gestito da un controllo server Web ASP.NET nella relativa ViewState proprietà. Questa infrastruttura viene usata dalle classi che derivano dalla PageStatePersister classe per mantenere lo stato di una pagina ASP.NET tra le richieste. Per impostazione predefinita, ASP.NET stato di pagina viene serializzato e deserializzato da un'istanza della ObjectStateFormatter classe . Tuttavia, gli sviluppatori di siti e adattatori possono implementare l'interfaccia IStateFormatter sui propri tipi per eseguire questa operazione.

Per altre informazioni sulla gestione dello stato e sullo stato di visualizzazione del controllo server Web, vedere ASP.NET State Management Overview e Dynamic Web Server Controls and View State.For more information about Web server control state management and view state, see ASP.NET State Overview and Dynamic Web Server Controls and View State.

Metodi

Deserialize(String)	Deserializza il grafico sullo stato di un oggetto a partire dal formato stringa serializzato.
Serialize(Object)	Serializza lo stato del controllo server Web ASP.NET in formato stringa.

Vedi anche

• PageStatePersister
• LosFormatter
• ObjectStateFormatter