Task.ConfigureAwait 方法

定義

命名空間:

System.Threading.Tasks

組件:

netstandard.dll, System.Runtime.dll

多載

名稱	Description
ConfigureAwait(Boolean)	配置一個等待者，過去會等待這個 Task。
ConfigureAwait(ConfigureAwaitOptions)	配置一個等待者，過去會等待這個 Task。

ConfigureAwait(Boolean)

來源:

Task.cs

配置一個等待者，過去會等待這個 Task。

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 時，接續通常會發生在建立該工作的相同執行緒中，這取決於非同步上下文。 此行為在效能方面的成本可能很高，而且可能會導致 UI 執行緒上的死結。 為避免這些問題，請致電 Task.ConfigureAwait(false)。 如需詳細資訊，請參閱 ConfigureAwait FAQ。

另請參閱

• ConfigureAwait 常見問題

ConfigureAwait(ConfigureAwaitOptions)

來源:

Task.cs

配置一個等待者，過去會等待這個 Task。

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 論證指定了一個無效的值。