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 を直接待機すると、非同期コンテキストによっては、タスクを作成したのと同じスレッドで継続が発生します。 この動作はパフォーマンスの面で大きな負担が生じ、その結果 UI スレッドでデッドロックが発生する可能性があります。 これらの問題を回避するには、 を呼び出します Task.ConfigureAwait(false)。 詳細については、「 ConfigureAwait FAQ」を参照してください。

こちらもご覧ください

• ConfigureAwait に関する FAQ

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 引数に無効な値が指定されています。