Control.ControlCollection.Clear Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Entfernt alle Steuerelemente aus der Auflistung.
public:
virtual void Clear();public virtual void Clear ();abstract member Clear : unit -> unit
override this.Clear : unit -> unitPublic 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 , 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.