Control.ControlCollection.Clear Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Entfernt alle Steuerelemente aus der Auflistung.

public:
 virtual void Clear();

public virtual void Clear ();

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

Public Overridable Sub Clear ()

Implementiert

Clear()

Beispiele

Im folgenden Codebeispiel werden alle Control Objekte in der Control.ControlCollection abgeleiteten Klasse Panelentfernt. Das Beispiel erfordert, dass Sie ein , ein , ein PanelButtonund mindestens ein anderes Steuerelement auf einem Form. Die anderen Steuerelemente werden dem Panel Steuerelement hinzugefügt und der Panel hinzugefügt Form. Wenn die Schaltfläche geklickt wird, werden alle im Bereich 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

Sie können die Methode verwenden, um die Clear gesamte Auflistung von Steuerelementen aus einem übergeordneten Steuerelement zu entfernen.

Um ein einzelnes Steuerelement aus der Auflistung zu entfernen, verwenden Sie die Remove Methoden oder RemoveAt Methoden.

Wichtig

Das Aufrufen der Clear Methode entfernt keine Steuerelementhandpunkte aus dem Arbeitsspeicher. Sie müssen die Dispose Methode explizit aufrufen, um Speicherlecks zu vermeiden.

Um der Auflistung neue Objekte hinzuzufügen Control , verwenden Sie die Add Methoden oder AddRange Methoden.

Hinweise für Vererber

Wenn sie in einer abgeleiteten Klasse außer Kraft Clear() gesetzt werden, müssen Sie die Methode der Basisklasse Clear() aufrufen, um sicherzustellen, dass alle Steuerelemente aus der Auflistung entfernt werden.