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.