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()

示例

下面的代码示例删除派生类Panel中的所有ControlControl.ControlCollection对象。 该示例要求你已创建一个Panel、一个Button和至少一个其他控件。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() 的方法，以确保从集合中删除所有控件。