CollectionBase.OnClear Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Realiza processos personalizados adicionais ao limpar o conteúdo da CollectionBase instância.
protected:
virtual void OnClear();protected virtual void OnClear();abstract member OnClear : unit -> unit
override this.OnClear : unit -> unitProtected Overridable Sub OnClear ()Observações
A implementação padrão deste método destina-se a ser sobreposta por uma classe derivada para realizar alguma ação antes de a coleção ser limpa.
Os métodos On* são invocados apenas na instância devolvida pela List propriedade, mas não na instância devolvida pela InnerList propriedade.
Se o processo falhar, a coleção regressa ao seu estado anterior.
A implementação padrão deste método é uma O(1) operação.
Notas para Herdeiros
Este método permite aos implementadores definir processos que devem ser realizados antes de eliminar todos os elementos do subjacente ArrayList. Ao definir este método, os implementadores podem adicionar funcionalidade aos métodos herdados sem terem de sobrescrever todos os outros métodos.
OnClear() é invocado antes do comportamento padrão Clear, enquanto OnClearComplete() é invocado após o comportamento padrão Clear.
Por exemplo, os implementadores podem isentar certos elementos da eliminação através de uma Limpeza global.