Page.RegisterRequiresControlState Method (Control)

.NET Framework (current version)

Other Versions

Registers a control as one whose control state must be persisted.

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

Syntax

C++

JScript

No code example is currently available or this language may not be supported.

Parameters

control: Type: System.Web.UI.Control
The control to register.

Exceptions

Exception	Condition
ArgumentException	The control to register is null.
InvalidOperationException	The RegisterRequiresControlState method can be called only before or during the PreRender event.

Custom server controls that use control state must call the RegisterRequiresControlState method on each request because registration for control state is not carried over from request to request during a postback event. It is recommended that registration occur in the Init event.

Examples

The following code example shows a custom server control calling the RegisterRequiresControlState method.

JScript

No code example is currently available or this language may not be supported.

Version Information

.NET Framework
Available since 2.0