Control.ControlCollection.Clear Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

Control.ControlCollection.cs

Eltávolítja az összes vezérlőt a gyűjteményből.

public:
 virtual void Clear();

public virtual void Clear();

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

Public Overridable Sub Clear ()

Megvalósítás

Clear()

Példák

Az alábbi példakód eltávolítja a Control származtatott osztály Control.ControlCollectionösszes objektumátPanel. A példához létre kell hoznia egy Panel, egy Buttonés legalább egy másik vezérlőt egy Form. A többi vezérlő hozzá lesz adva a Panel vezérlőhöz, és hozzáadódik a PanelForm . Ha a gombra kattint, a panelen található összes vezérlő el lesz távolítva a Control.ControlCollectionrendszerből.

   // 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

Megjegyzések

Ezzel a Clear módszerrel eltávolíthatja a vezérlők teljes gyűjteményét egy szülővezérlőből.

Ha el szeretne távolítani egy egyéni vezérlőt a gyűjteményből, használja a metódusokat vagy Remove a RemoveAt metódusokat.

Important

A metódus meghívása nem távolítja el a Clear vezérlőfogópontokat a memóriából. A memóriavesztés elkerülése érdekében explicit módon kell meghívnia a Dispose metódust.

Ha új Control objektumokat szeretne hozzáadni a gyűjteményhez, használja a metódusokat vagy Add a AddRange metódusokat.

Megjegyzések az öröklőkhöz

Származtatott osztály felülírásakor Clear() mindenképpen hívja meg az alaposztály metódusát Clear() , hogy az összes vezérlő el legyen távolítva a gyűjteményből.