CollectionBase.OnClear Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitProtected 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.
