MailMessage.Dispose 方法

定義

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

多載

Dispose(Boolean)

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

Dispose()

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

Dispose(Boolean)

釋放 MailMessage 所使用的 Unmanaged 資源,並選擇性地釋放 Managed 資源。Releases the unmanaged resources used by the MailMessage 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) 方法,並將 disposing 參數設定為 trueDispose() invokes 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 時,這個方法會釋放此 MailMessage 參考之任何 managed 物件所持有的所有資源。When the disposing parameter is true, this method releases all resources held by any managed objects that this MailMessage 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)).

Dispose()

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

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

實作

範例

下列程式碼範例將示範如何處置 MailMessageThe following code example demonstrates disposing a MailMessage.

備註

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

注意

在您釋放最後一個 Dispose 參考之前,請務必呼叫 MailMessageAlways call Dispose before you release your last reference to the MailMessage.

適用於