System.Web.UI.Control.SaveViewState Method

Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

Syntax

protected virtual object SaveViewState ()

Returns

Returns the server control's current view state. If there is no view state associated with the control, this method returns null.

Remarks

View state is the accumulation of the values of a server control's properties. These values are automatically placed in the server control's Control.ViewState property, which is an instance of the System.Web.UI.StateBag class. This property's value is then persisted to a string object after the save state stage of the server control life cycle. For more information, see Introduction to the ASP.NET Page Life Cycle.

When view state is saved, this string object is returned to the client as a variable that is stored in an HTML HIDDEN element. When you author a custom server control with a custom view state, the view state can be managed explicitly with the Control.SaveViewState and Control.LoadViewState(object) methods. For more information, see ASP.NET State Management Overview. For information on implementing a custom session-state provider, see Implementing a Session-State Store Provider.

Requirements

Namespace: System.Web.UI
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 1.0.5000.0, 2.0.0.0