Control.ControlCollection.Clear Control.ControlCollection.Clear Control.ControlCollection.Clear Control.ControlCollection.Clear Method

定義

コレクションからすべてのコントロールを削除します。 Removes all controls from the collection.

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します。The following code example removes all the Control objects in the Control.ControlCollection of the derived class Panel. 例では、作成済みである必要があります、 PanelButtonとの他の少なくとも 1 つのコントロール、Formします。The example requires that you have created a Panel, a Button, and at least one other control on a Form. 他のコントロールを追加、Panelコントロール、およびPanelに追加、Formします。The other controls are added to the Panel control, and the Panel added to the Form. パネルに含まれるすべてのコントロールを削除 ボタンがクリックされたときに、Control.ControlCollectionします。When the button is clicked, all the controls contained in the panel are removed from the 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親コントロールからコントロールのコレクション全体を削除する方法。You can use the Clear method to remove the entire collection of controls from a parent control.

コレクションから個々 のコントロールを削除するには、使用、RemoveまたはRemoveAtメソッド。To remove an individual control from the collection, use the Remove or RemoveAt methods.

重要

呼び出す、Clearメソッドはコントロール ハンドルをメモリから削除されません。Calling the Clear method does not remove control handles from memory. 明示的に呼び出す必要があります、Disposeメモリを回避するためのリークが発生します。You must explicitly call the Dispose method to avoid memory leaks.

新規追加にControlをコレクションにオブジェクトを使用して、AddまたはAddRangeメソッド。To add new Control objects to the collection, use the Add or AddRange methods.

注意 (継承者)

オーバーライドするときにClear()、派生クラスでは、基本クラスを呼び出す、Clear()のすべてのコントロールがコレクションから削除されるようにするメソッド。 When overriding Clear() in a derived class, be sure to call the base class's Clear() method to ensure that all the controls are removed from the collection.

適用対象