CollectionBase.OnClear Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Effectue des traitements personnalisés supplémentaires pendant l’effacement du contenu de l’instance de CollectionBase.
protected:
virtual void OnClear();protected virtual void OnClear ();abstract member OnClear : unit -> unit
override this.OnClear : unit -> unitProtected Overridable Sub OnClear ()Remarques
L’implémentation par défaut de cette méthode est destinée à être remplacée par une classe dérivée pour effectuer une action avant que la collection ne soit effacée.
Les méthodes On* sont appelées uniquement sur le instance retourné par la List propriété, mais pas sur le instance retourné par la InnerList propriété.
Si le processus échoue, la collection revient à son état précédent.
L’implémentation par défaut de cette méthode est une O(1) opération.
Notes pour les héritiers
Cette méthode permet aux implémenteurs de définir des processus qui doivent être effectués avant de supprimer tous les éléments du sous-jacent ArrayList. En définissant cette méthode, les implémenteurs peuvent ajouter des fonctionnalités aux méthodes héritées sans avoir à remplacer toutes les autres méthodes.
OnClear() est appelé avant le comportement Clear standard, alors qu’il OnClearComplete() est appelé après le comportement Clear standard.
Par exemple, les implémenteurs peuvent exempter certains éléments de la suppression par un clear global.
