CollectionBase.OnClear 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.
Esegue processi personalizzati aggiuntivi quando viene cancellato il contenuto dell'istanza di CollectionBase.
protected:
virtual void OnClear();
protected virtual void OnClear ();
abstract member OnClear : unit -> unit
override this.OnClear : unit -> unit
Protected Overridable Sub OnClear ()
Commenti
L'implementazione predefinita di questo metodo deve essere sottoposta a override da una classe derivata per eseguire un'azione prima che la raccolta venga cancellata.
I metodi On* vengono richiamati solo sull'istanza restituita dalla List proprietà , ma non sull'istanza restituita dalla InnerList proprietà .
Se il processo ha esito negativo, la raccolta torna allo stato precedente.
L'implementazione predefinita di questo metodo è un'operazione O(1)
.
Note per gli eredi
Questo metodo consente agli implementatori di definire i processi che devono essere eseguiti prima di eliminare tutti gli elementi dall'oggetto sottostante ArrayList. Definendo questo metodo, gli implementatori possono aggiungere funzionalità ai metodi ereditati senza dover eseguire l'override di tutti gli altri metodi.
OnClear() viene richiamato prima del comportamento Clear standard, mentre OnClearComplete() viene richiamato dopo il comportamento Clear standard.
Ad esempio, gli implementatori possono esentare determinati elementi dall'eliminazione da un clear globale.