Control.ClearChildControlState メソッド

.NET Framework クラス ライブラリ リファレンス

Control.ClearChildControlState メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

サーバー コントロールのすべての子コントロールについて、コントロールの状態情報を削除します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Sub ClearChildControlState

Visual Basic (使用法)

Me.ClearChildControlState

C#

protected void ClearChildControlState ()

C++

protected:
void ClearChildControlState ()

J#

protected void ClearChildControlState ()

JScript

protected function ClearChildControlState ()

解説

ClearChildControlState メソッドは、新しい子コントロールが作成されたとき (たとえば、テンプレート宣言されたデータ バインド サーバー コントロール内で子コントロールをデータ バインドする場合) に、親コントロールのコントロールの状態に書き込まれた子コントロールの状態情報をオーバーライドする場合に使用します。ClearChildControlState メソッドを呼び出して子コントロールの状態を空にした後で SaveControlState メソッドを呼び出すことにより、格納または送信しなければならないコントロールの状態情報のサイズが小さくなります。

Control オブジェクトの子コントロールを再作成するときは、既存の子コントロールの状態が新しいコントロールに誤って適用されないように、ClearChildControlState メソッドを使用して子コントロールの状態を削除してください。

子コントロールの状態およびビューステートの両方を削除するには、ClearChildState メソッドを使用します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間
ClearChildState
ClearChildViewState