Control.ClearChildControlState メソッド


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