Task.ConfigureAwait Метод

Определение

Пространство имен:

System.Threading.Tasks

Сборка:

System.Runtime.dll

Перегрузки

ConfigureAwait(Boolean)	Настраивает объект типа awaiter, используемый для данного объекта Task.
ConfigureAwait(ConfigureAwaitOptions)	Настраивает объект типа awaiter, используемый для данного объекта Task.

ConfigureAwait(Boolean)

Исходный код:

Task.cs

Настраивает объект типа awaiter, используемый для данного объекта 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 напрямую, продолжение обычно происходит в том же потоке, который создал задачу, в зависимости от асинхронного контекста. Такое поведение может быть дорогостоящим в плане производительности и может привести к взаимоблокировке потока пользовательского интерфейса. Чтобы избежать этих проблем, вызовите .Task.ConfigureAwait(false) Дополнительные сведения см. в разделе Часто задаваемые вопросы о НастройкеAwait.

См. также раздел

• Вопросы и ответы по ConfigureAwait

ConfigureAwait(ConfigureAwaitOptions)

Исходный код:

Task.cs

Настраивает объект типа awaiter, используемый для данного объекта 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 указывает недопустимое значение.