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 中 Control.ControlCollection 的所有 Control 物件。 此範例會要求您已在 上 Form 建立 Panel 、、 Button 和 至少一個其他控制項。 其他控制項會新增至 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() 方法，以確保從集合中移除所有控制項。