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. メソッドを呼び出す前に空の子コントロールに対してメソッドを呼び出すと、 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.