CollectionBase.OnClear 方法

当清除 CollectionBase 实例的内容时执行其他自定义进程。

**命名空间:**System.Collections
**程序集:**mscorlib(在 mscorlib.dll 中)

语法

声明
Protected Overridable Sub OnClear
用法

Me.OnClear
protected virtual void OnClear ()
protected:
virtual void OnClear ()
protected void OnClear ()
protected function OnClear ()

备注

此方法的默认实现需要由派生类重写,以便在清除集合之前执行某些操作。

仅对 List 属性所返回的实例调用 On* 方法,而不对 InnerList 属性所返回的实例调用这些方法。

如果进程失败,则集合恢复到其以前的状态。

此方法的默认实现的运算复杂度为 O(1)。

给实现者的说明 此方法允许实施者定义在从基础 System.Collections.ArrayList 中删除所有元素之前必须执行的进程。通过定义此方法,实施者可以向继承方法添加功能,而无须重写所有其他方法。 在标准的清除行为之前调用 OnClear,而在标准的清除行为之后调用 OnClearComplete。 例如,实施者可以通过全局“清除”(Clear) 使某些元素不被删除。

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表,请参见系统要求

版本信息

.NET Framework

受以下版本支持:2.0、1.1、1.0

.NET Compact Framework

受以下版本支持:2.0、1.0

请参见

参考

CollectionBase 类
CollectionBase 成员
System.Collections 命名空间
OnClearComplete
OnRemove