この記事の英語版を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語
このドキュメントはアーカイブされており、メンテナンスされていません。

Control.ControlCollection.Clear メソッド

コレクションからすべてのコントロールを削除します。

名前空間:  System.Windows.Forms
アセンブリ:  System.Windows.Forms (System.Windows.Forms.dll 内)

public virtual void Clear()

実装

IList.Clear()

Clear メソッドを使用して、親コントロールからコントロールのコレクション全体を削除できます。

コレクションからコントロールを個別に削除するには、Remove メソッドまたは RemoveAt メソッドを使用します。

重要 :重要

Clear メソッドを呼び出しても、コントロールのハンドルがメモリから削除されることはありません。 メモリ リークを防ぐには、Dispose メソッドを明示的に呼び出す必要があります。

新しい Control オブジェクトをコレクションに追加するには、Add メソッドまたは AddRange メソッドを使用します。

継承時の注意

派生クラスで Clear をオーバーライドする場合は、基本クラスの Clear メソッドを呼び出して、確実にすべてのコントロールがコレクションから削除されるようにしてください。

派生クラス PanelControl.ControlCollection に含まれるすべての Control オブジェクトを削除するコード例を次に示します。 この例では、Form 上に、PanelButton、および 1 つ以上のその他のコントロールが作成されている必要があります。 その他のコントロールは Panel コントロールに追加され、PanelForm に追加されます。 ボタンがクリックされると、パネルに含まれているすべてのコントロールが Control.ControlCollection から削除されます。


// Clear all the controls in the Panel.
private void clearButton_Click(object sender, System.EventArgs e)
{
   panel1.Controls.Clear();
}


.NET Framework

サポート対象: 4、3.5、3.0、2.0、1.1、1.0

.NET Framework Client Profile

サポート対象: 4、3.5 SP1

Windows 7, Windows Vista SP1 以降, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core はサポート対象外), Windows Server 2008 R2 (SP1 以降で Server Core をサポート), Windows Server 2003 SP2

.NET Framework では、各プラットフォームのすべてのバージョンはサポートしていません。 サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
表示: