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.
Например, реализующие могут исключить некоторые элементы из удаления глобальной очисткой.