Task Classe

Référence

Définition

Espace de noms:: System.Threading.Tasks

Assembly:: System.Threading.Tasks.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: Task.cs

Source:: Task.cs

Source:: Task.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente une opération asynchrone.

public ref class Task : IAsyncResult

public ref class Task : IAsyncResult, IDisposable

public class Task : IAsyncResult

public class Task : IAsyncResult, IDisposable

type Task = class
    interface IAsyncResult

type Task = class
    interface IAsyncResult
    interface IDisposable

Public Class Task
Implements IAsyncResult

Public Class Task
Implements IAsyncResult, IDisposable

Héritage: Object
Task

Dérivé: System.Threading.Tasks.Task<TResult>

Implémente: IAsyncResult IDisposable

Remarques

Pour plus d’informations sur cette API, consultez Remarques supplémentaires sur l’API pour la tâche.

Constructeurs

Task(Action)	Initialise un nouveau Task avec l'action spécifiée.
Task(Action, CancellationToken)	Initialise un nouveau Task avec l'action spécifiée et CancellationToken.
Task(Action, CancellationToken, TaskCreationOptions)	Initialise une nouvelle Task avec l'action et les options de création spécifiées.
Task(Action, TaskCreationOptions)	Initialise une nouvelle Task avec l'action et les options de création spécifiées.
Task(Action<Object>, Object)	Initialise un nouveau Task avec l'action et l'état spécifiés.
Task(Action<Object>, Object, CancellationToken)	Initialise un nouveau Task avec l’action, l’état et CancellationToken.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)	Initialise une nouvelle Task avec l'action, l'état et les options spécifiés.
Task(Action<Object>, Object, TaskCreationOptions)	Initialise une nouvelle Task avec l'action, l'état et les options spécifiés.

Propriétés

AsyncState	Obtient l'objet d'état fourni quand la Task a été créée, ou null si aucune n'a été fournie.
CompletedTask	Obtient une tâche qui s’est déjà terminée correctement.
CreationOptions	Obtient les TaskCreationOptions utilisées pour créer cette tâche.
CurrentId	Retourne l'ID de la Task en cours d'exécution.
Exception	Obtient le AggregateException qui a provoqué l'arrêt prématuré de Task. Si la Task s'est terminée avec succès ou n'a pas encore levé d'exception, la valeur `null` est retournée.
Factory	Fournit l'accès aux méthodes de fabrique pour la création d'instances de Task et de Task<TResult>.
Id	Obtient un ID pour cette instance de Task.
IsCanceled	Indique si cette instance de Task s'est exécutée avec succès suite à une annulation.
IsCompleted	Obtient une valeur indiquant si la tâche est terminée.
IsCompletedSuccessfully	Obtient une valeur indiquant si la tâche s’est exécutée jusqu’à son achèvement.
IsFaulted	Indique si la Task s'est terminée suite à une exception non gérée.
Status	Obtient le TaskStatus de cette tâche.

Méthodes

ConfigureAwait(Boolean)	Configure un élément awaiter utilisé pour attendre cette Task.
ConfigureAwait(ConfigureAwaitOptions)	Configure un élément awaiter utilisé pour attendre cette Task.
ContinueWith(Action<Task,Object>, Object)	Crée une continuation qui reçoit des informations d'état fournies par l'appelant et s'exécute quand le Task cible se termine.
ContinueWith(Action<Task,Object>, Object, CancellationToken)	Crée une continuation qui reçoit des informations d'état fournies par l'appelant et un jeton d'annulation, et qui s'exécute de façon asynchrone quand le Task cible se termine.
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crée une continuation qui reçoit des informations d'état fournies par l'appelant et un jeton d'annulation, et qui s'exécute quand le Task cible se termine. La continuation s'exécute selon un ensemble de conditions spécifiées et utilise un planificateur spécifié.
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)	Crée une continuation qui reçoit des informations d'état fournies par l'appelant et s'exécute quand le Task cible se termine. La continuation s'exécute selon un ensemble de conditions spécifiées.
ContinueWith(Action<Task,Object>, Object, TaskScheduler)	Crée une continuation qui reçoit des informations d'état fournies par l'appelant et s'exécute de façon asynchrone quand le Task cible se termine. La continuation utilise un planificateur spécifié.
ContinueWith(Action<Task>)	Crée une continuation qui s'exécute de façon asynchrone quand la Task cible se termine.
ContinueWith(Action<Task>, CancellationToken)	Crée une continuation qui reçoit un jeton d'annulation et s'exécute de façon asynchrone quand le Task cible se termine.
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)	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é.
ContinueWith(Action<Task>, TaskContinuationOptions)	Crée une continuation qui s’exécute quand la tâche cible se termine conformément au TaskContinuationOptions spécifié.
ContinueWith(Action<Task>, TaskScheduler)	Crée une continuation qui s'exécute de façon asynchrone quand la Task cible se termine. La continuation utilise un planificateur spécifié.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object)	Crée une continuation qui reçoit des informations d'état fournies par l'appelant et s'exécute de façon asynchrone quand le Task cible se termine et retourne une valeur.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)	Crée une continuation qui s'exécute de façon asynchrone quand le Task cible se termine et retourne une valeur. La continuation reçoit des informations d'état fournies par l'appelant et un jeton d'annulation.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crée une continuation qui s’exécute en fonction des options de continuation de tâche spécifiées quand le Task cible se termine et retourne une valeur. La continuation reçoit des informations d'état fournies par l'appelant et un jeton d'annulation et elle utilise un planificateur spécifié.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions)	Crée une continuation qui s’exécute en fonction des options de continuation de tâche spécifiées quand le Task cible se termine. La continuation reçoit des informations d'état fournies par l'appelant.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskScheduler)	Crée une continuation qui s'exécute de façon asynchrone quand la Task cible se termine. La continuation reçoit des informations d'état fournies par l'appelant et utilise un planificateur spécifié.
ContinueWith<TResult>(Func<Task,TResult>)	Crée une continuation qui s'exécute de façon asynchrone quand le Task<TResult> cible se termine et retourne une valeur.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)	Crée une continuation qui s'exécute de façon asynchrone quand le Task cible se termine et retourne une valeur. La continuation reçoit un jeton d'annulation.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crée une continuation qui s'exécute en fonction des options de continuation spécifiées et retourne une valeur. La continuation reçoit un jeton d'annulation et utilise un planificateur spécifié.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)	Crée une continuation qui s'exécute en fonction des options de continuation spécifiées et retourne une valeur.
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)	Crée une continuation qui s'exécute de façon asynchrone quand le Task cible se termine et retourne une valeur. La continuation utilise un planificateur spécifié.
Delay(Int32)	Crée une tâche qui se termine après un nombre spécifié de millisecondes.
Delay(Int32, CancellationToken)	Crée une tâche pouvant être annulée qui se termine après un nombre spécifié de millisecondes.
Delay(TimeSpan)	Crée une tâche qui se termine après un intervalle de temps spécifié.
Delay(TimeSpan, CancellationToken)	Crée une tâche pouvant être annulée qui se termine après un intervalle de temps spécifié.
Delay(TimeSpan, TimeProvider)	Crée une tâche qui se termine après un intervalle de temps spécifié.
Delay(TimeSpan, TimeProvider, CancellationToken)	Crée une tâche pouvant être annulée qui se termine après un intervalle de temps spécifié.
Dispose()	Libère toutes les ressources utilisées par l'instance actuelle de la classe Task.
Dispose(Boolean)	Supprime la Task, en libérant toutes ses ressources non managées.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FromCanceled(CancellationToken)	Crée une Task qui s'est terminée en raison de l'annulation avec un jeton d'annulation spécifié.
FromCanceled<TResult>(CancellationToken)	Crée une Task<TResult> qui s'est terminée en raison de l'annulation avec un jeton d'annulation spécifié.
FromException(Exception)	Crée une Task qui s'est terminée avec une exception spécifiée.
FromException<TResult>(Exception)	Crée une Task<TResult> qui s'est terminée avec une exception spécifiée.
FromResult<TResult>(TResult)	Crée un Task<TResult> qui s'est terminé avec succès avec le résultat spécifié.
GetAwaiter()	Obtient un élément awaiter utilisé pour attendre cette Task.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Run(Action)	Met en file d'attente le travail spécifié à exécuter dans le pool de threads et retourne un objet Task qui représente ce travail.
Run(Action, CancellationToken)	Met en file d'attente le travail spécifié à exécuter dans le pool de threads et retourne un objet Task qui représente ce travail. Un jeton d’annulation permet l’annulation du travail s’il n’a pas encore été commencé.
Run(Func<Task>)	Met en file d’attente le travail spécifié à exécuter sur le pool de threads et retourne un proxy pour la tâche retournée par `function`.
Run(Func<Task>, CancellationToken)	Met en file d’attente le travail spécifié à exécuter sur le pool de threads et retourne un proxy pour la tâche retournée par `function`. Un jeton d’annulation permet l’annulation du travail s’il n’a pas encore été commencé.
Run<TResult>(Func<Task<TResult>>)	Met en file d’attente le travail spécifié à exécuter dans le pool de threads et retourne un proxy pour le `Task(TResult)` retourné par `function`. Un jeton d’annulation permet l’annulation du travail s’il n’a pas encore été commencé.
Run<TResult>(Func<Task<TResult>>, CancellationToken)	Met en file d’attente le travail spécifié à exécuter dans le pool de threads et retourne un proxy pour le `Task(TResult)` retourné par `function`.
Run<TResult>(Func<TResult>)	Met en file d'attente le travail spécifié à exécuter dans le pool de threads et retourne un objet Task<TResult> qui représente ce travail. Un jeton d’annulation permet l’annulation du travail s’il n’a pas encore été commencé.
Run<TResult>(Func<TResult>, CancellationToken)	Met en file d'attente le travail spécifié à exécuter dans le pool de threads et retourne un objet `Task(TResult)` qui représente ce travail.
RunSynchronously()	Exécute de façon synchrone la Task sur le TaskScheduler actuel.
RunSynchronously(TaskScheduler)	Exécute de façon synchrone le Task sur le TaskScheduler fourni.
Start()	Démarre la Task, en planifiant son exécution sur le TaskScheduler actuel.
Start(TaskScheduler)	Démarre la Task, en planifiant son exécution sur le TaskScheduler spécifié.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
Wait()	Attend la fin de l'exécution de Task.
Wait(CancellationToken)	Attend la fin de l'exécution de Task. L'attente se termine si un jeton d'annulation est annulé avant la fin de la tâche.
Wait(Int32)	Attend la fin de l'exécution de la Task en un nombre de millisecondes spécifié.
Wait(Int32, CancellationToken)	Attend la fin de l'exécution de Task. L'attente se termine si un intervalle de délai est écoulé ou si un jeton d'annulation est annulé avant la fin de la tâche.
Wait(TimeSpan)	Attend la fin de l'exécution de la Task dans un intervalle de temps spécifié.
Wait(TimeSpan, CancellationToken)	Attend la fin de l'exécution de Task.
WaitAll(Task[])	Attend la fin de l'exécution de tous les objets Task fournis.
WaitAll(Task[], CancellationToken)	Attend la fin de l'exécution de tous les objets Task fournis sauf si l'attente est annulée.
WaitAll(Task[], Int32)	Attend la fin de l'exécution de tous les objets Task fournis en un nombre de millisecondes spécifié.
WaitAll(Task[], Int32, CancellationToken)	Attend la fin de l'exécution de tous les objets Task fournis en un nombre de millisecondes spécifié ou jusqu'à ce que l'attente soit annulée.
WaitAll(Task[], TimeSpan)	Attend la fin de l'exécution de tous les objets Task pouvant être annulés fournis dans un intervalle de temps spécifié.
WaitAny(Task[])	Attend la fin de l'exécution de l'un des objets Task fournis.
WaitAny(Task[], CancellationToken)	Attend la fin de l'exécution de l'un des objets Task fournis sauf si l'attente est annulée.
WaitAny(Task[], Int32)	Attend la fin de l'exécution de l'un des objets Task fournis en un nombre de millisecondes spécifié.
WaitAny(Task[], Int32, CancellationToken)	Attend la fin de l'exécution de l'un des objets Task fournis en un nombre de millisecondes spécifié ou jusqu'à ce qu'un jeton d'annulation soit annulé.
WaitAny(Task[], TimeSpan)	Attend la fin de l'exécution de n'importe lequel des objets Task fournis dans un intervalle de temps spécifié.
WaitAsync(CancellationToken)	Obtient un Task qui se termine à la fin de l’opération Task ou lorsque l’annulation demandée est demandée par le spécifié CancellationToken .
WaitAsync(TimeSpan)	Obtient un Task qui se termine à la fin de l’opération Task ou à l’expiration du délai d’expiration spécifié.
WaitAsync(TimeSpan, CancellationToken)	Obtient un Task qui se termine à la fin de cette Task opération, lorsque le délai d’expiration spécifié expire ou lorsque l’annulation spécifiée CancellationToken est demandée.
WaitAsync(TimeSpan, TimeProvider)	Obtient un Task qui se termine à la fin de l’opération Task ou à l’expiration du délai d’expiration spécifié.
WaitAsync(TimeSpan, TimeProvider, CancellationToken)	Obtient un Task qui se termine à la fin de cette Task opération, lorsque le délai d’expiration spécifié expire ou lorsque l’annulation spécifiée CancellationToken est demandée.
WhenAll(IEnumerable<Task>)	Crée une tâche qui s’achève quand tous les objets Task d’une collection énumérable sont terminés.
WhenAll(Task[])	Crée une tâche qui s’achève quand tous les objets Task d’un tableau sont terminés.
WhenAll<TResult>(IEnumerable<Task<TResult>>)	Crée une tâche qui s’achève quand tous les objets Task<TResult> d’une collection énumérable sont terminés.
WhenAll<TResult>(Task<TResult>[])	Crée une tâche qui s’achève quand tous les objets Task<TResult> d’un tableau sont terminés.
WhenAny(IEnumerable<Task>)	Crée une tâche qui s'achève lorsque l'une des tâches fournies est terminée.
WhenAny(Task, Task)	Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
WhenAny(Task[])	Crée une tâche qui s'achève lorsque l'une des tâches fournies est terminée.
WhenAny<TResult>(IEnumerable<Task<TResult>>)	Crée une tâche qui s'achève lorsque l'une des tâches fournies est terminée.
WhenAny<TResult>(Task<TResult>, Task<TResult>)	Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
WhenAny<TResult>(Task<TResult>[])	Crée une tâche qui s'achève lorsque l'une des tâches fournies est terminée.
Yield()	Crée une tâche pouvant être attendue qui se produit de manière asynchrone dans le contexte actuel pendant l’attente.

Implémentations d’interfaces explicites

IAsyncResult.AsyncWaitHandle	Obtient un WaitHandle qui peut être utilisé en attendant la fin de la tâche.
IAsyncResult.CompletedSynchronously	Obtient une indication précisant si l’opération s’est terminée de manière synchrone.

Méthodes d’extension

DispatcherOperationWait(Task)	Attend indéfiniment que l'opération DispatcherOperation sous-jacente se termine.
DispatcherOperationWait(Task, TimeSpan)	Attend pendant le délai spécifié que le DispatcherOperation sous-jacente se termine.
IsDispatcherOperationTask(Task)	Retourne une valeur qui indique si cette Task est associée à une DispatcherOperation.
AsAsyncAction(Task)	Retourne une action asynchrone Windows Runtime qui représente une tâche initiée.

S’applique à

Cohérence de thread

Tous les membres de , à l’exception de Task Dispose(), sont thread-safe et peuvent être utilisés simultanément à partir de plusieurs threads.