Page.UnregisterRequiresControlState(Control) Method

Definition

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

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

See also