Поделиться через


Task.ConfigureAwait Метод

Определение

Перегрузки

ConfigureAwait(Boolean)

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

ConfigureAwait(ConfigureAwaitOptions)

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

ConfigureAwait(Boolean)

Исходный код:
Task.cs
Исходный код:
Task.cs
Исходный код:
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.

Возвращаемое значение

Объект, используемый для ожидания данной задачи.

Комментарии

Когда асинхронный метод ожидает класс Task напрямую, продолжение обычно происходит в том же потоке, который создал задачу, в зависимости от асинхронного контекста. Такое поведение может быть дорогостоящим в плане производительности и может привести к взаимоблокировке потока пользовательского интерфейса. Чтобы избежать этих проблем, вызовите .Task.ConfigureAwait(false) Дополнительные сведения см. в разделе Часто задаваемые вопросы о НастройкеAwait.

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

Применяется к

ConfigureAwait(ConfigureAwaitOptions)

Исходный код:
Task.cs
Исходный код:
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

Параметры, используемые для настройки способа выполнения ожиданий для этой задачи.

Возвращаемое значение

Объект, используемый для ожидания данной задачи.

Исключения

Аргумент options указывает недопустимое значение.

Применяется к