System.Web.UI.WebControls.CheckBox.SaveViewState Method

Saves the changes to the System.Web.UI.WebControls.CheckBox view state since the time the page was posted back to the server.

Syntax

protected override object SaveViewState ()

Returns

The object that contains the changes to the System.Web.UI.WebControls.CheckBox view state; otherwise, if no view state is associated with the object, null.

Remarks

The CheckBox.SaveViewState method is used primarily by control developers.

View state is the accumulation of the values of a server control's properties. These values are automatically placed in the System.Web.UI.Control.ViewState property for the server control, 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's life cycle. For more information, see ASP.NET Page Life Cycle Overview.

When view state is saved, this string object is returned to the client as a variable that is stored in a hidden HTML input element. When you author custom server controls, you can improve efficiency by overriding the CheckBox.SaveViewState and modifying the System.Web.UI.Control.ViewState property for your server control. For more information, see Developing Custom ASP.NET Server Controls and ASP.NET State Management Overview.

Requirements

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