Control.ControlCollection.Clear Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Odebere všechny ovládací prvky z kolekce.

public:
 virtual void Clear();

public virtual void Clear ();

abstract member Clear : unit -> unit
override this.Clear : unit -> unit

Public Overridable Sub Clear ()

Implementuje

Clear()

Příklady

Následující příklad kódu odebere všechny Control objekty v Control.ControlCollection odvozené třídě Panel. Příklad vyžaduje, abyste vytvořili ovládací Panelprvek , aspoň Buttonjeden další ovládací prvek na .Form Ostatní ovládací prvky jsou přidány do Panel ovládacího prvku a přidány Panel do .Form Po kliknutí na tlačítko se z panelu odeberou všechny ovládací prvky obsažené v panelu 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

Poznámky

Pomocí Clear metody můžete odebrat celou kolekci ovládacích prvků z nadřazeného ovládacího prvku.

Pokud chcete odebrat jednotlivý ovládací prvek z kolekce, použijte metody Remove nebo RemoveAt metody.

Důležité

Clear Volání metody neodebere ovládací úchyty z paměti. Je nutné explicitně volat metodu Dispose , aby nedošlo k nevracení paměti.

Pokud chcete do kolekce přidat nové Control objekty, použijte metody Add nebo AddRange metody.

Poznámky pro dědice

Při přepsání Clear() v odvozené třídě nezapomeňte volat metodu základní třídy Clear() , aby se zajistilo, že všechny ovládací prvky budou odebrány z kolekce.