Task.ConfigureAwait 方法

定義

命名空間:

System.Threading.Tasks

組件:

System.Runtime.dll

多載

ConfigureAwait(Boolean)	設定用來等候這個 Task 的 awaiter。
ConfigureAwait(ConfigureAwaitOptions)	設定用來等候這個 Task 的 awaiter。

ConfigureAwait(Boolean)

來源:

Task.cs

設定用來等候這個 Task 的 awaiter。

public:
 System::Runtime::CompilerServices::ConfiguredTaskAwaitable ConfigureAwait(bool continueOnCapturedContext);

public System.Runtime.CompilerServices.ConfiguredTaskAwaitable ConfigureAwait (bool continueOnCapturedContext);

member this.ConfigureAwait : bool -> System.Runtime.CompilerServices.ConfiguredTaskAwaitable

Public Function ConfigureAwait (continueOnCapturedContext As Boolean) As ConfiguredTaskAwaitable

參數

continueOnCapturedContext

Boolean

true 表示嘗試將接續封送處理回原始擷取的內容，否則為 false。

傳回

ConfiguredTaskAwaitable

等候這項工作所用的物件。

備註

當非同步方法在直接等候 Task 時，接續通常會發生在建立工作的相同執行緒中，不過需視非同步的內容而定。 就效能的面向而言，此行為的成本可能很高，且可能會導致在使用者介面執行緒上產生死結。 若要避免這些問題，請呼叫 Task.ConfigureAwait(false) 。 如需詳細資訊，請參閱 ConfigureAwait 常見問題。

另請參閱

• ConfigureAwait 常見問題 (英文)

ConfigureAwait(ConfigureAwaitOptions)

來源:

Task.cs

設定用來等候這個 Task 的 awaiter。

public:
 System::Runtime::CompilerServices::ConfiguredTaskAwaitable ConfigureAwait(System::Threading::Tasks::ConfigureAwaitOptions options);

public System.Runtime.CompilerServices.ConfiguredTaskAwaitable ConfigureAwait (System.Threading.Tasks.ConfigureAwaitOptions options);

member this.ConfigureAwait : System.Threading.Tasks.ConfigureAwaitOptions -> System.Runtime.CompilerServices.ConfiguredTaskAwaitable

Public Function ConfigureAwait (options As ConfigureAwaitOptions) As ConfiguredTaskAwaitable

參數

options

ConfigureAwaitOptions

用來設定此工作等候執行方式的選項。

傳回

ConfiguredTaskAwaitable

等候這項工作所用的物件。

例外狀況

ArgumentOutOfRangeException

options 引數指定了無效的值。