Control.ControlCollection.Clear Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.