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

定義

サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。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 ()

注釈

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.

適用対象

こちらもご覧ください