Control.ControlCollection.Clear Metod

Definition

Tar bort alla kontroller från samlingen.

public:
 virtual void Clear();
public virtual void Clear();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Overridable Sub Clear ()

Implementeringar

Exempel

Följande kodexempel tar bort alla Control objekt i den Control.ControlCollection härledda klassen Panel. Exemplet kräver att du har skapat en Panel, en Buttonoch minst en annan kontroll på en Form. De andra kontrollerna läggs till i Panel kontrollen och läggs Panel till i Form. När du klickar på knappen tas alla kontroller i panelen bort från 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

Kommentarer

Du kan använda Clear metoden för att ta bort hela samlingen med kontroller från en överordnad kontroll.

Om du vill ta bort en enskild kontroll från samlingen använder du Remove metoderna eller RemoveAt .

Important

Clear Att anropa metoden tar inte bort kontrollreferenser från minnet. Du måste uttryckligen Dispose anropa metoden för att undvika minnesläckor.

Om du vill lägga till nya Control objekt i samlingen använder du Add metoderna eller AddRange .

Anteckningar till arvingar

När du Clear() åsidosätter i en härledd klass måste du anropa basklassens Clear() metod för att säkerställa att alla kontroller tas bort från samlingen.

Gäller för