Control.ControlCollection.Clear メソッド

定義

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

public:
 virtual void Clear();
public virtual void Clear ();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Overridable Sub Clear ()

実装

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

   // Clear all the controls in the Panel.
private:
   void clearButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      panel1->Controls->Clear();
   }
// Clear all the controls in the Panel.
private void clearButton_Click(object sender, System.EventArgs e)
{
   panel1.Controls.Clear();
}
' Clear all the controls in the Panel.
Private Sub ClearButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles ClearButton.Click
    Panel1.Controls.Clear()
End Sub

注釈

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

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

重要

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

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

注意 (継承者)

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

適用対象