Control.Dispose(Boolean) 方法

定義

釋放 Control 所使用的 Unmanaged 資源,以及其子系的控制項,並會選擇性地釋放一些 Managed 資源。Releases the unmanaged resources used by the Control and its child controls and optionally releases the managed resources.

protected:
 override void Dispose(bool disposing);
protected override void Dispose (bool disposing);
override this.Dispose : bool -> unit
Protected Overrides Sub Dispose (disposing As Boolean)

參數

disposing
Boolean

true 表示釋放 Managed 和 Unmanaged 資源,false 則表示只釋放 Unmanaged 資源。true to release both managed and unmanaged resources; false to release only unmanaged resources.

備註

這個方法是由公用 Dispose() 方法和 Finalize 方法所呼叫。 Dispose()This method is called by the public Dispose() method and the Finalize method.Dispose() 叫用受保護的 Dispose(Boolean) 方法,並將 disposing 參數設定為 trueinvokes the protected Dispose(Boolean) method with the disposing parameter set to true. Finalize 會叫用 Dispose,並將 disposing 設定為 falseFinalize invokes Dispose with disposing set to false.

disposing 參數為 true 時,這個方法會釋放 Control 參考的任何 Managed 物件所掌握的資源。When the disposing parameter is true, this method releases all resources held by any managed objects that this Control references. 這個方法會叫用每個參考物件的 Dispose() 方法。This method invokes the Dispose() method of each referenced object.

給繼承者的注意事項

Dispose 可以被其他物件呼叫多次。 Dispose can be called multiple times by other objects. 當覆寫 Dispose(Boolean) 時,請小心不要參考先前在呼叫 Dispose 之前處置過的物件。When overriding Dispose(Boolean) be careful not to reference objects that have been previously disposed of in an earlier call to Dispose. 如需如何執行 Dispose(Boolean) 的詳細資訊,請參閱[執行 Dispose 方法](~/docs/standard/garbage-collection/implementing-dispose.md)。For more information about how to implement Dispose(Boolean), see [Implementing a Dispose Method](~/docs/standard/garbage-collection/implementing-dispose.md). 如需 DisposeFinalize() 的詳細資訊,請參閱[清除非受控資源](~/docs/standard/garbage-collection/unmanaged.md)和覆[寫 Finalize 方法](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100))。For more information about Dispose and Finalize(), see [Cleaning Up Unmanaged Resources](~/docs/standard/garbage-collection/unmanaged.md) and [Overriding the Finalize Method](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/ddae83kx(v=vs.100)).

適用於