CollectionBase.OnClear Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.