Page.UnregisterRequiresControlState Method (Control)


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

Stops persistence of control state for the specified control.

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

Public Sub UnregisterRequiresControlState (
	control As Control


Type: System.Web.UI.Control

The Control for which to stop persistence of control state.

Exception Condition

The Control is null.

Custom server controls that use control state must call the RegisterRequiresControlState on each request during before the state is persisted. Registration for control state is not carried over from request to request during a postback. Use the UnregisterRequiresControlState method to ensure that control state is not persisted for controls that no longer need to be persisted for postback.

Internally, the UnregisterRequiresControlState method is invoked when using the RemovedControl method to remove a control from a controls collection.

.NET Framework
Available since 2.0
Return to top