Control.ControlCollection.Clear-Methode

Entfernt alle Steuerelemente aus der Auflistung.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Overridable Sub Clear
'Usage
Dim instance As ControlCollection

instance.Clear

public virtual void Clear ()

public:
virtual void Clear ()

public void Clear ()

public function Clear ()

Hinweise

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

Mit der Remove-Methode oder der RemoveAt-Methode können Sie ein einzelnes Steuerelement aus der Auflistung entfernen.

Wichtig

Durch Aufrufen der Clear-Methode werden keine Steuerelementhandles aus dem Arbeitsspeicher entfernt. Sie müssen die Dispose-Methode explizit aufrufen, um Speicherverluste zu vermeiden.

Verwenden Sie die Add-Methode oder die AddRange-Methode, um der Auflistung neue Control-Objekte hinzuzufügen.

Hinweise für Erben Wenn Sie Clear in einer abgeleiteten Klasse überschreiben, müssen Sie die Clear-Methode der Basisklasse aufrufen, um sicherzustellen, dass alle Steuerelemente aus der Auflistung entfernt werden.

Beispiel

Im folgenden Codebeispiel werden alle Control-Objekte aus der Control.ControlCollection des Panel der abgeleiteten Klasse entfernt. Im Beispiel wird davon ausgegangen, dass ein Panel, ein Button und mindestens ein anderes Steuerelement in einem Form erstellt wurden. Die anderen Steuerelemente werden dem Panel-Steuerelement hinzugefügt, und das Panel wird dem Form hinzugefügt. Beim Klicken auf die Schaltfläche werden alle im Bereich enthaltenen Steuerelemente aus der Control.ControlCollection entfernt.

' 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 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 void clearButton_Click(Object sender, System.EventArgs e)
{
    panel1.get_Controls().Clear();
} //clearButton_Click

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Control.ControlCollection-Klasse
Control.ControlCollection-Member
System.Windows.Forms-Namespace