CollectionBase.OnClear 方法

定義

命名空間:

System.Collections

組件:

System.Collections.NonGeneric.dll

來源:

CollectionBase.cs

在清除 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 刪除特定元素。

另請參閱

• OnClearComplete()
• OnRemove(Int32, Object)