Control.ControlCollection.Clear Methode

public:
 virtual void Clear();

public virtual void Clear();

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

Public Overridable Sub Clear ()

Implementiert

Beispiele

Im folgenden Codebeispiel werden alle Control Objekte in der Control.ControlCollection abgeleiteten Klasse Panelentfernt. Das Beispiel erfordert, dass Sie ein Panel, a Button, und mindestens ein anderes Steuerelement für ein .Form Die anderen Steuerelemente werden dem Panel Steuerelement und dem Panel Steuerelement hinzugefügt Form. Wenn auf die Schaltfläche geklickt wird, werden alle im Panel enthaltenen Steuerelemente aus dem Control.ControlCollectionBereich entfernt.

   // 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

Hinweise

Mit der Clear Methode können Sie die gesamte Auflistung von Steuerelementen aus einem übergeordneten Steuerelement entfernen.

Wenn Sie ein einzelnes Steuerelement aus der Auflistung entfernen möchten, verwenden Sie die Remove oder RemoveAt die Methoden.

Wenn Sie der Auflistung neue Control Objekte hinzufügen möchten, verwenden Sie die Add oder AddRange die Methoden.

Hinweise für Vererber

Achten Sie beim Überschreiben Clear() in einer abgeleiteten Klasse darauf, die Methode der Basisklasse Clear() aufzurufen, um sicherzustellen, dass alle Steuerelemente aus der Auflistung entfernt werden.