DictionaryBase.OnClear-Methode

Führt vor dem Löschen des Inhalts der DictionaryBase-Instanz zusätzliche benutzerdefinierte Prozesse aus.

Namespace: System.Collections
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Protected Overridable Sub OnClear
'Usage

Me.OnClear

protected virtual void OnClear ()

protected:
virtual void OnClear ()

protected void OnClear ()

protected function OnClear ()

Hinweise

Überschreiben Sie die Standardimplementierung dieser Methode durch eine abgeleitete Klasse, wenn vor dem Löschen der Auflistung zusätzliche Aktionen ausgeführt werden sollen.

Die On*-Methoden werden lediglich für die von der Dictionary-Eigenschaft zurückgegebene Instanz aufgerufen, jedoch nicht für die von der InnerHashtable-Eigenschaft zurückgegebene Instanz.

Die Standardimplementierung dieser Methode ist ein O(1)-Vorgang.

Hinweise für Implementierer Mithilfe der Methode können während der Implementierung Prozesse definiert werden, die vor dem Löschen aller Elemente der zugrunde liegenden System.Collections.Hashtable ausgeführt werden müssen. Durch eine Definition dieser Methode kann der Funktionsumfang vererbter Methoden bei der Implementierung erweitert werden, ohne alle anderen Methoden überschreiben zu müssen. OnClear wird vor dem Standardverhalten von Clear aufgerufen, OnClearComplete hingegen nach dem Standardverhalten von Clear. Beispielsweise können einzelne Elemente durch ein globales Clear vom Löschvorgang ausgenommen werden.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DictionaryBase-Klasse
DictionaryBase-Member
System.Collections-Namespace
OnClearComplete
OnRemove