Task.ConfigureAwait 方法

定义

命名空间:

System.Threading.Tasks

程序集:

System.Runtime.dll

重载

ConfigureAwait(Boolean)	配置用于等待此 Task的 awaiter。
ConfigureAwait(ConfigureAwaitOptions)	配置用于等待此 Task的 awaiter。

ConfigureAwait(Boolean)

Source:

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 常见问题解答。

另请参阅

• ConfigureAwait 常见问题解答

ConfigureAwait(ConfigureAwaitOptions)

Source:

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 参数指定的值无效。