Control.ControlCollection.Clear Metoda

Definice

Odebere všechny ovládací prvky z kolekce.Removes all controls from the collection.

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

Implementuje

Příklady

Následující příklad kódu odebere všechny Control objekty v Control.ControlCollection odvozené třídě Panel .The following code example removes all the Control objects in the Control.ControlCollection of the derived class Panel. Příklad vyžaduje, abyste vytvořili Panel , Button a a alespoň jeden další ovládací prvek na Form .The example requires that you have created a Panel, a Button, and at least one other control on a Form. Ostatní ovládací prvky jsou přidány do Panel ovládacího prvku a Panel přidány do Form .The other controls are added to the Panel control, and the Panel added to the Form. Po kliknutí na tlačítko jsou všechny ovládací prvky obsažené v panelu odebrány z Control.ControlCollection .When the button is clicked, all the controls contained in the panel are removed from the 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

Můžete použít Clear metodu pro odebrání celé kolekce ovládacích prvků z nadřazeného ovládacího prvku.You can use the Clear method to remove the entire collection of controls from a parent control.

Chcete-li odebrat individuální ovládací prvek z kolekce, použijte Remove RemoveAt metody nebo.To remove an individual control from the collection, use the Remove or RemoveAt methods.

Důležité

Volání Clear metody neodebere ovládací úchyty z paměti.Calling the Clear method does not remove control handles from memory. Musíte explicitně zavolat Dispose metodu, aby nedošlo k nevracení paměti.You must explicitly call the Dispose method to avoid memory leaks.

Chcete-li přidat nové Control objekty do kolekce, použijte Add AddRange metody nebo.To add new Control objects to the collection, use the Add or AddRange methods.

Poznámky pro dědice

Při přepsání Clear() v odvozené třídě nezapomeňte zavolat metodu základní třídy, Clear() aby se zajistilo, že všechny ovládací prvky budou odebrány z kolekce.When overriding Clear() in a derived class, be sure to call the base class's Clear() method to ensure that all the controls are removed from the collection.

Platí pro