Control.ClearChildControlState Control.ClearChildControlState Control.ClearChildControlState Control.ClearChildControlState Method


サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。Deletes the control-state information for the server control's child controls.

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


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. 呼び出す、ClearChildControlStateメソッドを呼び出す前に空の子コントロールに、SaveControlStateメソッドは、格納または転送される必要があるコントロールの状態情報のサイズを縮小します。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.

子コントロールを再作成するときに、Controlオブジェクトを使用して、ClearChildControlStateことは適用されない新しいコントロールに誤ってように子コントロールの状態をクリアします。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.

両方を削除する子コントロールの状態とビューの状態を使用して、ClearChildStateメソッド。To clear both the child control state and view state, use the ClearChildState method.