CollectionBase.OnClear Methode

Definition

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Quelle:

CollectionBase.cs

Führt beim Löschen des Inhalts der CollectionBase-Instanz zusätzliche benutzerdefinierte Prozesse aus.

protected:
 virtual void OnClear();

protected virtual void OnClear ();

abstract member OnClear : unit -> unit
override this.OnClear : unit -> unit

Protected Overridable Sub OnClear ()

Hinweise

Die Standardimplementierung dieser Methode soll von einer abgeleiteten Klasse überschrieben werden, um eine Aktion auszuführen, bevor die Auflistung gelöscht wird.

Die On*-Methoden werden nur für die von der List -Eigenschaft zurückgegebene instance aufgerufen, aber nicht für die von der InnerList -Eigenschaft zurückgegebene instance.

Wenn der Prozess fehlschlägt, wird die Sammlung wieder in den vorherigen Zustand zurückgesetzt.

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

Hinweise für Vererber

Mit dieser Methode können Implementierer Prozesse definieren, die ausgeführt werden müssen, bevor alle Elemente aus dem zugrunde liegenden ArrayListgelöscht werden. Durch das Definieren dieser Methode können Implementierer geerbten Methoden Funktionen hinzufügen, ohne alle anderen Methoden außer Kraft setzen zu müssen.

OnClear() wird vor dem Standardmäßigen Clear-Verhalten aufgerufen, während OnClearComplete() nach dem Standardmäßigen Clear-Verhalten aufgerufen wird.

Beispielsweise können Implementierer bestimmte Elemente vom Löschen durch ein globales Clear-Element ausschließen.

Weitere Informationen

• OnClearComplete()
• OnRemove(Int32, Object)