Afficher en anglais

Partage via

Task.ConfigureAwait Méthode

  • Référence

Définition

Espace de noms:
System.Threading.Tasks
Assemblys:
mscorlib.dll, System.Threading.Tasks.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Threading.Tasks.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Surcharges

ConfigureAwait(Boolean)

Configure un élément awaiter utilisé pour attendre cette Task.
ConfigureAwait(ConfigureAwaitOptions)

Configure un élément awaiter utilisé pour attendre cette Task.

ConfigureAwait(Boolean)

Source:
Task.cs
Source:
Task.cs
Source:
Task.cs

Configure un élément awaiter utilisé pour attendre cette Task.

C# 
public System.Runtime.CompilerServices.ConfiguredTaskAwaitable ConfigureAwait(bool continueOnCapturedContext);

Paramètres

continueOnCapturedContext
Boolean

true en cas de tentative de marshaling de la continuation vers le contexte d'origine capturé ; sinon, false.

Retours

ConfiguredTaskAwaitable

Objet utilisé pour attendre cette tâche.

Remarques

Lorsqu’une méthode asynchrone attend une Task directement, la continuation se produit généralement dans le même thread que celui qui a créé la tâche, en fonction du contexte asynchrone. Ce comportement peut être coûteux en termes de performances et peut entraîner un blocage sur le thread d’interface utilisateur. Pour éviter ces problèmes, appelez Task.ConfigureAwait(false). Pour plus d’informations, consultez Faq sur la configuration de l’application.

Voir aussi

S’applique à

.NET 10 et autres versions
Produit Versions
.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, 10
.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

ConfigureAwait(ConfigureAwaitOptions)

Source:
Task.cs
Source:
Task.cs

Configure un élément awaiter utilisé pour attendre cette Task.

C# 
public System.Runtime.CompilerServices.ConfiguredTaskAwaitable ConfigureAwait(System.Threading.Tasks.ConfigureAwaitOptions options);

Paramètres

options
ConfigureAwaitOptions

Options utilisées pour configurer la façon dont les attentes sur cette tâche sont effectuées.

Retours

ConfiguredTaskAwaitable

Objet utilisé pour attendre cette tâche.

Exceptions

ArgumentOutOfRangeException

L'argument options spécifie une valeur non valide.

S’applique à

.NET 10 et autres versions
Produit Versions
.NET 8, 9, 10