IStateFormatter.Serialize(Object) Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Serialisiert den Zustand eines ASP.NET-Webserversteuerelement in Zeichenfolgenform.

public:
 System::String ^ Serialize(System::Object ^ state);

public string Serialize (object state);

abstract member Serialize : obj -> string

Public Function Serialize (state As Object) As String

Parameter

state

Object

Das Objekt, das den Ansichtszustand des Webserversteuerelements zum Serialisieren in Zeichenfolgenform darstellt.

Gibt zurück

String

Eine Zeichenfolge, die den Ansichtszustand eines Webserversteuerelements darstellt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Serialize Methode die Statusinformationen einer Datei beibehalten. Die Save Methode der Klasse verwendet die IStateFormatter von der StreamPageStatePersister PageStatePersister Klasse geerbte Schnittstelle, um den Ansichtszustand zu serialisieren. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die IStateFormatter Schnittstelle bereitgestellt wird.

//
// 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.");
        }
    }
}

'
' 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

Hinweise

Verwenden Sie die Serialize Methode, um ein Objektstatusdiagramm in Zeichenfolgenformular zu transformieren. Restituieren Sie ein Zustandsobjekt aus der Zeichenfolge mithilfe der Deserialize Methode.