Control.ClearChildControlState Method
Definition
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.
Deletes the control-state information for the server control's child controls.
protected:
void ClearChildControlState();protected void ClearChildControlState ();member this.ClearChildControlState : unit -> unitProtected Sub ClearChildControlState ()Remarks
The ClearChildControlState method is used when child control-state information written to the parent control's control state is overridden as new child controls are created, such as when data-binding child controls in a templated data-bound server control. Calling the ClearChildControlState method to empty child controls before calling the SaveControlState method reduces the size of the control-state information that must be stored or transmitted.
When recreating child controls of a Control object, use the ClearChildControlState method to clear child control state so that it does not get applied to the new controls inadvertently.
To clear both the child control state and view state, use the ClearChildState method.
