Control.ControlCollection.Clear Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Rimuove tutti i controlli dall'insieme.

public:
 virtual void Clear();

public virtual void Clear ();

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

Public Overridable Sub Clear ()

Implementazioni

Clear()

Esempio

Nell'esempio Control.ControlCollection di codice seguente vengono rimossi tutti gli Control oggetti nella classe Panelderivata . L'esempio richiede che sia stato creato un Paneloggetto , un Buttone almeno un altro controllo in un Formoggetto . Gli altri controlli vengono aggiunti al Panel controllo e aggiunti Panel a Form. Quando si fa clic sul pulsante, tutti i controlli contenuti nel pannello vengono rimossi dall'oggetto 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

Commenti

È possibile usare il Clear metodo per rimuovere l'intera raccolta di controlli da un controllo padre.

Per rimuovere un singolo controllo dalla raccolta, usare i Remove metodi o RemoveAt .

Importante

La chiamata al metodo non rimuove gli handle di Clear controllo dalla memoria. È necessario chiamare in modo esplicito il Dispose metodo per evitare perdite di memoria.

Per aggiungere nuovi Control oggetti alla raccolta, usare i Add metodi o AddRange .

Note per gli eredi

Quando si esegue l'override Clear() in una classe derivata, assicurarsi di chiamare il metodo della Clear() classe di base per assicurarsi che tutti i controlli vengano rimossi dalla raccolta.