共用方式為


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

實作

範例

下列程式碼範例會移除衍生類別 PanelControl.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 方法,從父控制項移除整個控制項集合。

若要從集合中移除個別控制項,請使用 RemoveRemoveAt 方法。

重要

Clear呼叫 方法並不會從記憶體中移除控制項控制碼。 您必須明確呼叫 Dispose 方法,以避免記憶體流失。

若要將新 Control 物件加入至集合,請使用 AddAddRange 方法。

給繼承者的注意事項

Clear() 衍生類別中覆寫時,請務必呼叫基類的 Clear() 方法,以確保從集合中移除所有控制項。

適用於