CollectionBase.OnClear Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Выполняет дополнительные пользовательские действия при очистке содержимого экземпляра CollectionBase.
protected:
virtual void OnClear();
protected virtual void OnClear ();
abstract member OnClear : unit -> unit
override this.OnClear : unit -> unit
Protected Overridable Sub OnClear ()
Комментарии
Реализация этого метода по умолчанию переопределяется производным классом для выполнения некоторых действий перед очисткой коллекции.
Методы On* вызываются только для экземпляра, возвращаемого свойством List , но не для экземпляра, возвращаемого свойством InnerList .
Если процесс завершается сбоем, коллекция возвращается к предыдущему состоянию.
Реализация этого метода по умолчанию является операцией O(1)
.
Примечания для тех, кто наследует этот метод
Этот метод позволяет реализации определять процессы, которые необходимо выполнить перед удалением всех элементов из базового ArrayListобъекта. Определив этот метод, реализующие могут добавлять функциональные возможности в унаследованные методы, не переопределяя все остальные методы.
OnClear() вызывается перед стандартным поведением Clear, тогда как OnClearComplete() вызывается после стандартного поведения Clear.
Например, средства реализации могут исключить определенные элементы из удаления с помощью глобального clear.