Task.ConfigureAwait Método

Definição

Namespace:: System.Threading.Tasks

Assemblies:: mscorlib.dll, System.Threading.Tasks.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Threading.Tasks.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
ConfigureAwait(Boolean)	Configura um aguardador usado para aguardar isso Task.
ConfigureAwait(ConfigureAwaitOptions)	Configura um aguardador usado para aguardar isso Task.

ConfigureAwait(Boolean)

Origem:: Task.cs

Origem:: Task.cs

Origem:: Task.cs

Origem:: Task.cs

Origem:: Task.cs

Configura um aguardador usado para aguardar isso 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 fazer marshaling da continuação de volta para o 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 dispendioso em termos de desempenho e pode resultar em um deadlock na thread da interface do usuário. Para evitar esses problemas, chame Task.ConfigureAwait(false). Para obter mais informações, consulte As perguntas frequentes sobre ConfigureAwait.

Confira também

Perguntas frequentes sobre o ConfigureAwait

Aplica-se a

ConfigureAwait(ConfigureAwaitOptions)

Origem:: Task.cs

Origem:: Task.cs

Origem:: Task.cs

Origem:: Task.cs

Configura um aguardador usado para aguardar isso 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 os esperas nesta tarefa são executados.

Retornos

ConfiguredTaskAwaitable

Um objeto usado para aguardar essa tarefa.

Exceções

ArgumentOutOfRangeException

O options argumento especifica um valor inválido.

Aplica-se a

Comentários

Esta página foi útil?