Task.ConfigureAwait Metoda

Definicja

Przestrzeń nazw:

System.Threading.Tasks

Zestaw:

System.Runtime.dll

Przeciążenia

ConfigureAwait(Boolean)	Konfiguruje obiekt awaiter używany do oczekiwania na ten Taskelement .
ConfigureAwait(ConfigureAwaitOptions)	Konfiguruje obiekt awaiter używany do oczekiwania na ten Taskelement .

ConfigureAwait(Boolean)

Konfiguruje obiekt awaiter używany do oczekiwania na ten Taskelement .

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

Parametry

continueOnCapturedContext

Boolean

true aby podjąć próbę marshalingu kontynuacji z powrotem do oryginalnego kontekstu przechwyconego; w przeciwnym razie , false.

Zwraca

ConfiguredTaskAwaitable

Obiekt służący do oczekiwania na to zadanie.

Uwagi

Gdy metoda asynchroniczna oczekuje Task bezpośrednio, kontynuacja zwykle występuje w tym samym wątku, który utworzył zadanie, w zależności od kontekstu asynchronicznego. Takie zachowanie może być kosztowne pod względem wydajności i może spowodować zakleszczenie wątku interfejsu użytkownika. Aby uniknąć tych problemów, wywołaj metodę Task.ConfigureAwait(false). Aby uzyskać więcej informacji, zobacz ConfigureAwait FAQ (Często zadawane pytania dotyczące konfigurowania elementu ConfigureAwait).

Zobacz też

• ConfigureAwait — często zadawane pytania

ConfigureAwait(ConfigureAwaitOptions)

Konfiguruje obiekt awaiter używany do oczekiwania na ten Taskelement .

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

Parametry

options

ConfigureAwaitOptions

Opcje używane do konfigurowania sposobu oczekiwania na to zadanie są wykonywane.

Zwraca

ConfiguredTaskAwaitable

Obiekt służący do oczekiwania na to zadanie.

Wyjątki

ArgumentOutOfRangeException

Argument options określa nieprawidłową wartość.