ClearChildControlState Method

Control.ClearChildControlState Method ()


Deletes the control-state information for the server control's child controls.

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

protected void ClearChildControlState()

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.

.NET Framework
Available since 2.0
Return to top
© 2015 Microsoft