Control.ControlCollection.Clear Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rimuove tutti i controlli dalla raccolta.
public:
virtual void Clear();
public virtual void Clear();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Overridable Sub Clear ()
Implementazioni
Esempio
Nell'esempio di codice seguente vengono rimossi tutti gli Control oggetti della Control.ControlCollection classe Panelderivata . L'esempio richiede che sia stato creato un Panelcontrollo , un Buttone almeno un altro controllo in un oggetto Form. Gli altri controlli vengono aggiunti al Panel controllo e l'oggetto Panel aggiunto all'oggetto Form. Quando si fa clic sul pulsante, tutti i controlli contenuti nel pannello vengono rimossi da 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 utilizzare il Clear metodo per rimuovere l'intera raccolta di controlli da un controllo padre.
Per rimuovere un singolo controllo dalla raccolta, utilizzare i Remove metodi o RemoveAt .
Importante
La chiamata al Clear metodo non rimuove gli handle di controllo dalla memoria. È necessario chiamare in modo esplicito il Dispose metodo per evitare perdite di memoria.
Per aggiungere nuovi Control oggetti alla raccolta, utilizzare 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 base per assicurarsi che tutti i controlli vengano rimossi dalla raccolta.