Task.ConfigureAwait Метод

Определение

Пространство имен:
System.Threading.Tasks
Сборки:
mscorlib.dll, System.Threading.Tasks.dll
Сборки:
netstandard.dll, System.Runtime.dll
Сборка:
System.Threading.Tasks.dll
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll

Перегрузки

Имя Описание
ConfigureAwait(Boolean)

Настраивает средство ожидания, используемое для ожидания этого Task.
ConfigureAwait(ConfigureAwaitOptions)

Настраивает средство ожидания, используемое для ожидания этого Task.

ConfigureAwait(Boolean)

Исходный код:
Task.cs
Исходный код:
Task.cs
Исходный код:
Task.cs
Исходный код:
Task.cs
Исходный код:
Task.cs

Настраивает средство ожидания, используемое для ожидания этого 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). Дополнительные сведения см. в разделе Вопросы и ответы о ConfigureAwait.

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

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

ConfigureAwait(ConfigureAwaitOptions)

Исходный код:
Task.cs
Исходный код:
Task.cs
Исходный код:
Task.cs
Исходный код:
Task.cs

Настраивает средство ожидания, используемое для ожидания этого 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 задает недопустимое значение.

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