Page.UnregisterRequiresControlState(Control) Method

Reference

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Stops persistence of control state for the specified control.

public:
 void UnregisterRequiresControlState(System::Web::UI::Control ^ control);

public void UnregisterRequiresControlState (System.Web.UI.Control control);

member this.UnregisterRequiresControlState : System.Web.UI.Control -> unit

Public Sub UnregisterRequiresControlState (control As Control)

Parameters

control: Control

The Control for which to stop persistence of control state.

Exceptions

ArgumentException

The Control is null.

Remarks

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.

Applies to

Dela via