CollectionBase.OnClear Méthode

Définition

Effectue des traitements personnalisés supplémentaires pendant l’effacement du contenu de l’instance de CollectionBase.Performs additional custom processes when clearing the contents of the CollectionBase instance.

protected:
 virtual void OnClear();
protected virtual void OnClear ();
abstract member OnClear : unit -> unit
override this.OnClear : unit -> unit
Protected Overridable Sub OnClear ()

Remarques

L’implémentation par défaut de cette méthode est destinée à être substituée par une classe dérivée pour effectuer une action avant que la collection soit effacée.The default implementation of this method is intended to be overridden by a derived class to perform some action before the collection is cleared.

Les méthodes on * sont appelées uniquement sur l’instance retournée par la propriété List, mais pas sur l’instance retournée par la propriété InnerList.The On* methods are invoked only on the instance returned by the List property, but not on the instance returned by the InnerList property.

Si le processus échoue, la collection revient à son état précédent.If the process fails, the collection reverts back to its previous state.

L’implémentation par défaut de cette méthode est une opération de O(1).The default implementation of this method is an O(1) operation.

Notes pour les héritiers

Cette méthode permet aux implémenteurs de définir des processus qui doivent être exécutés avant de supprimer tous les éléments de la ArrayListsous-jacente.This method allows implementers to define processes that must be performed before deleting all the elements from the underlying ArrayList. En définissant cette méthode, les implémenteurs peuvent ajouter des fonctionnalités aux méthodes héritées sans avoir à substituer toutes les autres méthodes.By defining this method, implementers can add functionality to inherited methods without having to override all other methods.

OnClear() est appelé avant le comportement Clear standard, tandis que OnClearComplete() est appelé après le comportement Clear standard.OnClear() is invoked before the standard Clear behavior, whereas OnClearComplete() is invoked after the standard Clear behavior.

Par exemple, les implémenteurs peuvent exempter certains éléments de la suppression par un Clear global.For example, implementers can exempt certain elements from deletion by a global Clear.

S’applique à

Voir aussi