DictionaryBase.OnClear メソッド

DictionaryBase インスタンスの内容を消去する前に、追加のカスタム プロセスを実行します。

Protected Overridable Sub OnClear()
[C#]
protected virtual void OnClear();
[C++]
protected: virtual void OnClear();
[JScript]
protected function OnClear();

解説

このメソッドの既定の実装は、コレクションの消去前にアクションを実行するために、派生クラスによってオーバーライドされます。

On* メソッドは、 Dictionary プロパティによって返されたインスタンスに対してだけ呼び出され、 InnerHashtable プロパティによって返されたインスタンスに対しては呼び出されません。

実装時の注意:

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

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

たとえば、グローバルな Clear 操作で削除を実行する場合、特定の要素だけを削除せずに残すことができます。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

DictionaryBase クラス | DictionaryBase メンバ | System.Collections 名前空間 | OnClearComplete | OnRemove