Control.ControlCollection.Clear メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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

public:
 virtual void Clear();

public virtual void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Overridable Sub Clear ()

実装

Clear()

例

次のコード例では、Control派生クラス Panelの のすべての Control.ControlCollection オブジェクトを削除します。 この例では、 に 、Button、および 少なくとも 1 つの他のコントロールをForm作成Panelしている必要があります。 他のコントロールは コントロールに 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 使用して、コントロールのコレクション全体を親コントロールから削除できます。

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

重要

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

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

注意 (継承者)

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