CollectionBase.OnClear Método

Definición

Realiza procesos personalizados adicionales al borrar el contenido de la instancia 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 ()

Comentarios

La implementación predeterminada de este método se ha diseñado para que lo invalide una clase derivada para realizar alguna acción antes de que se borre la colección.The default implementation of this method is intended to be overridden by a derived class to perform some action before the collection is cleared.

Los métodos on * se invocan solo en la instancia devuelta por la propiedad List, pero no en la instancia devuelta por la propiedad 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 se produce un error en el proceso, la colección vuelve a su estado anterior.If the process fails, the collection reverts back to its previous state.

La implementación predeterminada de este método es una operación de O(1).The default implementation of this method is an O(1) operation.

Notas a los desarrolladores de herederos

Este método permite a los implementadores definir procesos que se deben realizar antes de eliminar todos los elementos de la ArrayListsubyacente.This method allows implementers to define processes that must be performed before deleting all the elements from the underlying ArrayList. Al definir este método, los implementadores pueden agregar funcionalidad a los métodos heredados sin tener que reemplazar todos los demás métodos.By defining this method, implementers can add functionality to inherited methods without having to override all other methods.

OnClear() se invoca antes que el comportamiento de Clear estándar, mientras que OnClearComplete() se invoca después del comportamiento de Clear estándar.OnClear() is invoked before the standard Clear behavior, whereas OnClearComplete() is invoked after the standard Clear behavior.

Por ejemplo, los implementadores pueden eximir a determinados elementos de la eliminación por un borrado global.For example, implementers can exempt certain elements from deletion by a global Clear.

Se aplica a

Consulte también: