This documentation is archived and is not being maintained.

SqlDataSourceView.SaveViewState Method

Note: This method is new in the .NET Framework version 2.0.

Saves the changes to the view state for the SqlDataSourceView control since the time that the page was posted back to the server.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

protected virtual Object SaveViewState ()
protected Object SaveViewState ()
protected function SaveViewState () : Object

Return Value

The object that contains the changes to the SqlDataSourceView view state; otherwise, a null reference (Nothing in Visual Basic), if there is no view state associated with the object.

The SaveViewState method is primarily used by control developers.

View state is the accumulation of the values of the properties for a server control. These values are automatically placed in the ViewState property for the server control, which is an instance of the StateBag class. The ViewState value for the server control is then persisted to a string object after the save state stage of the server control life cycle.

When view state is saved, the string object that was persisted after the save state stage of the server control life cycle 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 the SaveViewState method and modifying the ViewState property for your server control. For more information, see ASP.NET State Management Overview.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0