Component.Dispose 方法

定義

釋放 Component 使用的資源。Releases the resources used by the Component.

多載

Dispose()

釋放 Component 所使用的所有資源。Releases all resources used by the Component.

Dispose(Boolean)

釋放 Component 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。Releases the unmanaged resources used by the Component and optionally releases the managed resources.

Dispose()

釋放 Component 所使用的所有資源。Releases all resources used by the Component.

public:
 virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

實作

備註

Dispose 使用完畢時,請呼叫 ComponentCall Dispose when you are finished using the Component. Dispose 方法會將 Component 保留在無法使用的狀態。The Dispose method leaves the Component in an unusable state. 呼叫Dispose之後, 您必須釋放所有對的Component參考, 讓垃圾收集行程可以Component回收所佔用的記憶體。After calling Dispose, you must release all references to the Component so the garbage collector can reclaim the memory that the Component was occupying. 如需詳細資訊, 請參閱清除非受控資源執行 Dispose 方法For more information, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

注意

在您釋放最後一個 Dispose 參考之前,請務必呼叫 ComponentAlways call Dispose before you release your last reference to the Component. 否則工作窗格所使用的資源不會釋放,直到記憶體回收行程呼叫 Component 物件的 Finalize 方法。Otherwise, the resources it is using will not be freed until the garbage collector calls the Component object's Finalize method.

另請參閱

Dispose(Boolean)

釋放 Component 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。Releases the unmanaged resources used by the Component and optionally releases the managed resources.

protected:
 virtual void Dispose(bool disposing);
protected virtual void Dispose (bool disposing);
abstract member Dispose : bool -> unit
override this.Dispose : bool -> unit
Protected Overridable 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和方法所呼叫。This method is called by the public Dispose method and the Finalize method. Dispose()Dispose(Boolean) 用受true保護的方法, 並將參數設定為。disposingDispose() invokes the protected Dispose(Boolean) method with the disposing parameter set to true. Finalize使用設定disposingfalse的叫用。 DisposeFinalize invokes Dispose with disposing set to false.

disposing 參數為 true 時,這個方法會釋放 Component 參考的任何 Managed 物件所掌握的資源。When the disposing parameter is true, this method releases all resources held by any managed objects that this Component 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 的早期呼叫中被處置 (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)).

適用於