Control.ClearChildControlState Method

Definition

Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur.Deletes the control-state information for the server control's child controls.

protected:
 void ClearChildControlState();
protected void ClearChildControlState ();
member this.ClearChildControlState : unit -> unit
Protected Sub ClearChildControlState ()

Remarks

La méthode ClearChildControlState est utilisée lorsque les informations d’état de contrôle enfants écrites dans l’état de contrôle du contrôle parent sont remplacées à mesure que de nouveaux contrôles enfants sont créés, par exemple lors de la liaison de données aux contrôles enfants d’un contrôle serveur lié aux données basé sur un modèle.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. L’appel de la méthode ClearChildControlState pour vider des contrôles enfants avant d’appeler la méthode SaveControlState réduit la taille des informations d’état de contrôle qui doivent être stockées ou transmises.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.

Lorsque vous recréez les contrôles enfants d’un objet Control, utilisez la méthode ClearChildControlState pour effacer l’état du contrôle enfant afin qu’il ne soit pas appliqué par inadvertance aux nouveaux contrôles.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.

Pour effacer l’état du contrôle enfant et l’état d’affichage, utilisez la méthode ClearChildState.To clear both the child control state and view state, use the ClearChildState method.

Applies to

See also