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、Form、および他のコントロールを少なくとも 1 つ作成している必要があります。 他のコントロールがPanel コントロールに追加され、PanelFormに追加されます。 ボタンをクリックすると、パネルに含まれるすべてのコントロールが 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 メソッドを使用します。

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

注意 (継承者)

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