Task.ConfigureAwait Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
ConfigureAwait(Boolean) |
Configura un awaiter utilizado para esperar a este objeto Task. |
ConfigureAwait(ConfigureAwaitOptions) |
Configura un awaiter utilizado para esperar a este objeto Task. |
- 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);
public System.Runtime.CompilerServices.ConfiguredTaskAwaitable ConfigureAwait (bool continueOnCapturedContext);
member this.ConfigureAwait : bool -> System.Runtime.CompilerServices.ConfiguredTaskAwaitable
Public Function ConfigureAwait (continueOnCapturedContext As Boolean) As ConfiguredTaskAwaitable
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 |
- 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);
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
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 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: