Compartilhar via


Task.ConfigureAwait Método

Definição

Sobrecargas

ConfigureAwait(Boolean)

Configura um awaiter usado para aguardar este Task.

ConfigureAwait(ConfigureAwaitOptions)

Configura um awaiter usado para aguardar este Task.

ConfigureAwait(Boolean)

Origem:
Task.cs
Origem:
Task.cs
Origem:
Task.cs

Configura um awaiter usado para aguardar este 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 tentar realizar marshaling da continuação de volta ao contexto original capturado; caso contrário, false.

Retornos

Um objeto usado para aguardar essa tarefa.

Comentários

Quando um método assíncrono aguarda um Task diretamente, a continuação normalmente ocorre no mesmo thread que criou a tarefa, dependendo do contexto assíncrono. Esse comportamento pode ser caro em termos de desempenho e pode resultar em um deadlock no thread da IU. Para evitar esses problemas, chame Task.ConfigureAwait(false). Para obter mais informações, confira Perguntas frequentes sobre ConfigureAwait.

Confira também

Aplica-se a

ConfigureAwait(ConfigureAwaitOptions)

Origem:
Task.cs
Origem:
Task.cs

Configura um awaiter usado para aguardar este 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

Opções usadas para configurar como as esperas nesta tarefa são executadas.

Retornos

Um objeto usado para aguardar essa tarefa.

Exceções

O argumento options especifica um valor inválido.

Aplica-se a