Task.ConfigureAwait Método

Definição

Namespace:

System.Threading.Tasks

Assembly:

System.Runtime.dll

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

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

ConfiguredTaskAwaitable

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

• Perguntas frequentes sobre o ConfigureAwait

ConfigureAwait(ConfigureAwaitOptions)

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

ConfiguredTaskAwaitable

Um objeto usado para aguardar essa tarefa.

Exceções

ArgumentOutOfRangeException

O argumento options especifica um valor inválido.