IStateManager.SaveViewState Method

StateBag.IStateManager.SaveViewState Method ()


Saves the changes to the StateBag object since the time the page was posted back to the server.

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

object IStateManager.SaveViewState()

Return Value

Type: System.Object

The object that contains the changes to the view state of the StateBag. If there are no changes, or there are no StateItem elements in the StateBag, this method returns null.

This method is primarily used by control developers.

View state is the accumulation of the values of a server control's properties. These values are automatically placed in the server control's ViewState property, which is an instance of the 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 NIB: ASP.NET Web Server Controls.

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 custom server controls, you can improve efficiency by overriding this method and modifying your server control's ViewState property. For more information, see NIB: ASP.NET Web Server Controls and ASP.NET State Management Overview.

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft