Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Task.ContinueWith méthode (Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)

 

Date de publication : novembre 2016

Crée une continuation qui s'exécute quand la tâche cible se termine conformément au TaskContinuationOptions spécifié. La continuation reçoit un jeton d'annulation et utilise un planificateur spécifié.

Espace de noms:   System.Threading.Tasks
Assembly:  mscorlib (dans mscorlib.dll)

public Task ContinueWith(
	Action<Task> continuationAction,
	CancellationToken cancellationToken,
	TaskContinuationOptions continuationOptions,
	TaskScheduler scheduler
)

Paramètres

continuationAction
Type: System.Action<Task>

Action à exécuter selon le continuationOptionsspécifié. Quand elle est exécutée, la tâche achevée est passée au délégué en tant qu’argument.

cancellationToken
Type: System.Threading.CancellationToken

CancellationToken qui sera assigné à la nouvelle tâche de continuation.

continuationOptions
Type: System.Threading.Tasks.TaskContinuationOptions

Options applicables quand la continuation est planifiée et qui en régissent le comportement. Cela inclut des critères, tels que OnlyOnCanceled, ainsi que des options d'exécution, telles que ExecuteSynchronously.

scheduler
Type: System.Threading.Tasks.TaskScheduler

TaskScheduler à associer à la tâche de continuation et à utiliser pour son exécution.

Valeur de retour

Type: System.Threading.Tasks.Task

Nouvelle Task de continuation.

Exception Condition
ObjectDisposedException

Le CancellationTokenSource qui a créé le jeton a déjà été supprimé.

ArgumentNullException

Le continuationAction argument est null.

ou

Le scheduler argument est null.

ArgumentOutOfRangeException

Le continuationOptions argument spécifie une valeur non valide pour TaskContinuationOptions.

Retourné Task ne sera pas planifié pour l’exécution jusqu'à ce que la tâche en cours terminée. Si les critères spécifiés par le biais du continuationOptions paramètre ne sont pas remplies, la tâche de continuation sera annulée au lieu d’être planifiée.

Voici un exemple d’utilisation de ContinueWith pour exécuter des travaux en arrière-plan et sur l’utilisateur de threads d’interface.


private void Button1_Click(object sender, EventArgs e)
{
   var backgroundScheduler = TaskScheduler.Default;
   var uiScheduler = TaskScheduler.FromCurrentSynchronizationContext();
   Task.Factory.StartNew(delegate { DoBackgroundComputation(); },
                         backgroundScheduler).
   ContinueWith(delegate { UpdateUI(); }, uiScheduler).
                ContinueWith(delegate { DoAnotherBackgroundComputation(); },
                             backgroundScheduler).
                ContinueWith(delegate { UpdateUIAgain(); }, uiScheduler);
}

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 4.0
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 5.0
Silverlight pour Windows Phone
Disponible depuis 8.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: