CollectionBase.OnClear Método

Definición

Realiza procesos personalizados adicionales al borrar el contenido de la instancia CollectionBase.

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 está pensada para ser invalidada por una clase derivada para realizar alguna acción antes de que se borre la colección.

Los métodos On* solo se invocan en la instancia devuelta por la List propiedad , pero no en la instancia devuelta por la InnerList propiedad .

Si se produce un error en el proceso, la colección vuelve a su estado anterior.

La implementación predeterminada de este método es una O(1) operación.

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 del subyacente ArrayList. Al definir este método, los implementadores pueden agregar funcionalidad a los métodos heredados sin tener que invalidar todos los demás métodos.

OnClear() se invoca antes del comportamiento clear estándar, mientras que OnClearComplete() se invoca después del comportamiento clear estándar.

Por ejemplo, los implementadores pueden excluir determinados elementos de la eliminación por parte de un Clear global.

Se aplica a

Consulte también