IStateFormatter.Deserialize(String) Method

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Deserializes an object state graph from its serialized string form.

public:
 System::Object ^ Deserialize(System::String ^ serializedState);

public object Deserialize (string serializedState);

abstract member Deserialize : string -> obj

Public Function Deserialize (serializedState As String) As Object

Parameters

serializedState

String

A string that the IStateFormatter deserializes into an initialized object.

Returns

Object

An object that represents the state of an ASP.NET server control.

Examples

The following code example demonstrates how the Deserialize method loads view state information. The Load method of the StreamPageStatePersister class uses the IStateFormatter interface inherited from the PageStatePersister class to deserialize view state. This code example is part of a larger example provided for the IStateFormatter interface.

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

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

Remarks

Use the Deserialize method to reconstitute the state object for an ASP.NET page or server control that has been serialized using the Serialize method.