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.ConfiguredTaskAwaitablePublic 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.ConfiguredTaskAwaitablePublic Function ConfigureAwait (options As ConfigureAwaitOptions) As ConfiguredTaskAwaitableПараметры
- options
- ConfigureAwaitOptions
Параметры, используемые для настройки способа выполнения ожиданий для этой задачи.
Возвращаемое значение
Объект, используемый для ожидания данной задачи.
Исключения
Аргумент options указывает недопустимое значение.
