ChangePassword.SaveControlState Method ()


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Use BaseTrue

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

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

protected internal override object SaveControlState()

Return Value

Type: System.Object

The server control's current state; otherwise, null.

Use the SaveControlState method to save state information required for the operation of the ChangePassword control. This control state data is stored separately from the view state data for the ChangePassword control.

Custom controls using control state must call the RegisterRequiresControlState method on the Page object before saving control state.

Notes to Inheritors:

When control state is saved, a string object is returned to the client as a variable that is stored in an HTML <input type="hidden" /> element. Override the SaveControlState method to extract the state information to use in the ChangePassword control.

Control state is intended for small amounts of critical data, such as a page index or a keyword. Using control state for large amounts of data can adversely affect page performance.

.NET Framework
Available since 2.0
Return to top