CollectionBase.OnClear メソッド

定義

名前空間:

System.Collections

アセンブリ:

System.Collections.NonGeneric.dll

ソース:

CollectionBase.cs

CollectionBase インスタンスの内容を消去しているときに、追加のカスタム プロセスを実行します。

C#

protected virtual void OnClear ();

注釈

このメソッドの既定の実装は、コレクションがクリアされる前に何らかのアクションを実行するために、派生クラスによってオーバーライドされることを目的としています。

On* メソッドは、 プロパティによって List 返されるインスタンスでのみ呼び出されますが、 プロパティによって InnerList 返されるインスタンスでは呼び出されません。

プロセスが失敗した場合、コレクションは以前の状態に戻ります。

このメソッドの既定の実装は 操作です O(1) 。

注意 (継承者)

このメソッドを使用すると、実装者は、基になる ArrayListからすべての要素を削除する前に実行する必要があるプロセスを定義できます。 このメソッドを定義することで、実装者は、他のすべてのメソッドをオーバーライドすることなく、継承されたメソッドに機能を追加できます。

OnClear() は標準の Clear 動作の前に呼び出されますが OnClearComplete() 、標準の Clear 動作の後に呼び出されます。

たとえば、実装者は、グローバル Clear によって特定の要素を削除から除外できます。

適用対象

こちらもご覧ください

• OnClearComplete()
• OnRemove(Int32, Object)