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

Implementeringen

Voorbeelden

In het Control volgende codevoorbeeld worden alle objecten in de Control.ControlCollection afgeleide klasse Panelverwijderd. Voor het voorbeeld moet u een Panel, een Buttonen ten minste één ander besturingselement op een Formhebben gemaakt. De andere besturingselementen worden toegevoegd aan het Panel besturingselement en de Panel besturingselementen worden toegevoegd aan het Formbesturingselement. Wanneer op de knop wordt geklikt, worden alle besturingselementen in het deelvenster verwijderd uit de 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

Opmerkingen

U kunt de Clear methode gebruiken om de volledige verzameling besturingselementen uit een bovenliggend besturingselement te verwijderen.

Als u een afzonderlijk besturingselement uit de verzameling wilt verwijderen, gebruikt u de Remove of RemoveAt methoden.

Als u nieuwe Control objecten wilt toevoegen aan de verzameling, gebruikt u de Add of AddRange methoden.

Notities voor overnemers

Wanneer u overschrijft Clear() in een afgeleide klasse, moet u de methode van Clear() de basisklasse aanroepen om ervoor te zorgen dat alle besturingselementen uit de verzameling worden verwijderd.