Control.ControlCollection.Clear 方法 (System.Windows.Forms)

public virtual void Clear ();

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

Public Overridable Sub Clear ()

Clear()

下面的代码示例删除派生类 Panel 中的所有 Control Control.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()
      
      的方法，以确保从集合中删除所有控件。