CollectionBase.OnClear Método

Definição

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Origem:

CollectionBase.cs

Executa processos personalizados adicionais ao limpar o conteúdo da instância CollectionBase.

protected:
 virtual void OnClear();

protected virtual void OnClear ();

abstract member OnClear : unit -> unit
override this.OnClear : unit -> unit

Protected Overridable Sub OnClear ()

Comentários

A implementação padrão desse método destina-se a ser substituída por uma classe derivada para executar alguma ação antes que a coleção seja desmarcada.

Os métodos On* são invocados apenas na instância retornada pela List propriedade , mas não na instância retornada pela InnerList propriedade .

Se o processo falhar, a coleção será revertida para seu estado anterior.

A implementação padrão desse método é uma O(1) operação.

Notas aos Herdeiros

Esse método permite que os implementadores definam processos que devem ser executados antes de excluir todos os elementos do subjacente ArrayList. Ao definir esse método, os implementadores podem adicionar funcionalidade aos métodos herdados sem precisar substituir todos os outros métodos.

OnClear() é invocado antes do comportamento padrão Desmarcado, enquanto OnClearComplete() é invocado após o comportamento padrão clear.

Por exemplo, os implementadores podem isentar determinados elementos da exclusão por um Clear global.

Confira também

• OnClearComplete()
• OnRemove(Int32, Object)