CollectionBase.OnClear メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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 によって特定の要素を削除から除外できます。