IStateFormatter.Serialize Method (Object)


Serializes ASP.NET Web server control state to string form.

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

string Serialize(
	object state


Type: System.Object

The object that represents the view state of the Web server control to serialize to string form.

Return Value

Type: System.String

A string that represents a Web server control's view state.

Use the Serialize method to transform an object state graph to string form. Reconstitute a state object from the string using the Deserialize method.

The following code example demonstrates how the Serialize method persists view state information to a file. The Save method of the StreamPageStatePersister class uses the IStateFormatter interface inherited from the PageStatePersister class to serialize view state. This code example is part of a larger example provided for the IStateFormatter interface.

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

            throw new InvalidOperationException("Session needed for StreamPageStatePersister.");

.NET Framework
Available since 2.0
Return to top