Task.Dispose 方法

定義

命名空間:

System.Threading.Tasks

組件:

System.Runtime.dll

釋放 Task 類別目前的執行個體所使用的全部資源。

多載

Dispose(Boolean)	處置 Task，並釋放它的所有 Unmanaged 資源。
Dispose()	釋放 Task 類別目前的執行個體所使用的全部資源。

Dispose(Boolean)

來源:

Task.cs

處置 Task，並釋放它的所有 Unmanaged 資源。

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

布林值，表示是否會因為呼叫 Dispose() 而呼叫這個方法。

例外狀況

InvalidOperationException

工作不是下列其中一個最終狀態：RanToCompletion、Faulted 或 Canceled。

備註

類別 Task 會實作 IDisposable 介面，因為它會在內部使用同時實 IDisposable作的資源。 不過，特別是如果您的應用程式以 .NET Framework 4.5 或更新版本為目標，Dispose除非效能或延展性測試指出根據您的使用模式，您的應用程式效能會透過處置工作來改善。 如需詳細資訊，請參閱使用 .NET 的平行程序設計部落格中的 是否需要處置工作？ 。

執行緒安全性

不同於類別的大部分 Task 成員，這個方法不是安全線程。

Dispose()

來源:

Task.cs

釋放 Task 類別目前的執行個體所使用的全部資源。

public:
 virtual void Dispose();

public void Dispose ();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub Dispose ()

實作

Dispose()

例外狀況

InvalidOperationException

工作不是下列其中一個最終狀態：RanToCompletion、Faulted 或 Canceled。

備註

類別 Task 會實作 IDisposable 介面，因為它會在內部使用同時實 IDisposable作的資源。 不過，特別是如果您的應用程式以 .NET Framework 4.5 或更新版本為目標，Dispose除非效能或延展性測試指出根據您的使用模式，您的應用程式效能會透過處置工作來改善。 如需詳細資訊，請參閱使用 .NET 的平行程序設計部落格中的 是否需要處置工作？ 。