CollectionBase.OnClear Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitProtected 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.
