CollectionBase.OnClear 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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