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 其他控制項會加入控制項 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 or RemoveAt 方法。

要新增 Control 物件到集合中，請使用 Add or AddRange 方法。

給繼承者的注意事項

在導出類別中覆 Clear() 寫時，務必呼叫基底類別的方法 Clear() ，確保所有控制項都從集合中移除。