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.ControlCollectionPanel对象。 该示例要求你已创建一个 Panel、一个 Button，以及至少一个控件上的其他控件 Form。 其他控件将添加到 Panel 控件中，并 Panel 添加到控件中 Form。 单击按钮时，面板中包含的所有控件都将从 /> 中删除。

   // 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() 的方法，以确保从集合中删除所有控件。