Task.ConfigureAwait Método

Definición

Sobrecargas

ConfigureAwait(Boolean)

Configura un awaiter utilizado para esperar a este objeto Task.

ConfigureAwait(ConfigureAwaitOptions)

Configura un awaiter utilizado para esperar a este objeto Task.

ConfigureAwait(Boolean)

Source:
Task.cs
Source:
Task.cs
Source:
Task.cs

Configura un awaiter utilizado para esperar a este objeto Task.

public System.Runtime.CompilerServices.ConfiguredTaskAwaitable ConfigureAwait (bool continueOnCapturedContext);

Parámetros

continueOnCapturedContext
Boolean

true para intentar calcular las referencias de la continuación de nuevo al contexto original capturado; en caso contrario, false.

Devoluciones

Objeto utilizado para esperar a esta tarea.

Comentarios

Cuando un método asincrónico espera un Task directamente, la continuación se produce normalmente en el mismo subproceso que creó la tarea, dependiendo del contexto asincrónico. Este comportamiento puede ser costoso en términos de rendimiento y puede dar lugar a un interbloqueo en el subproceso de la interfaz de usuario. Para evitar estos problemas, llame a Task.ConfigureAwait(false). Para obtener más información, consulte Preguntas más frecuentes sobre ConfigureAwait.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ConfigureAwait(ConfigureAwaitOptions)

Source:
Task.cs
Source:
Task.cs

Configura un awaiter utilizado para esperar a este objeto Task.

public System.Runtime.CompilerServices.ConfiguredTaskAwaitable ConfigureAwait (System.Threading.Tasks.ConfigureAwaitOptions options);

Parámetros

options
ConfigureAwaitOptions

Opciones usadas para configurar cómo se realizan las esperas en esta tarea.

Devoluciones

Objeto utilizado para esperar a esta tarea.

Excepciones

El argumento options especifica un valor no válido.

Se aplica a

.NET 9 y .NET 8
Producto Versiones
.NET 8, 9