IStateFormatter.Deserialize Method (String)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Deserializes an object state graph from its serialized string form.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

object Deserialize(
	string serializedState


Type: System.String

A string that the IStateFormatter deserializes into an initialized object.

Return Value

Type: System.Object

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

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.

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;

.NET Framework
Available since 2.0
Return to top