Task.WhenAny Méthode
Définition
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.
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
Surcharges
| 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 se termine lorsque l’une des tâches fournies est terminée. |
| WhenAny(ReadOnlySpan<Task>) |
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée. |
| WhenAny(IEnumerable<Task>) |
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée. |
| WhenAny<TResult>(IEnumerable<Task<TResult>>) |
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée. |
| WhenAny<TResult>(ReadOnlySpan<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 se termine 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(Task, Task)
- Source:
- Task.cs
- Source:
- Task.cs
- Source:
- Task.cs
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
public:
static System::Threading::Tasks::Task<System::Threading::Tasks::Task ^> ^ WhenAny(System::Threading::Tasks::Task ^ task1, System::Threading::Tasks::Task ^ task2);public static System.Threading.Tasks.Task<System.Threading.Tasks.Task> WhenAny (System.Threading.Tasks.Task task1, System.Threading.Tasks.Task task2);static member WhenAny : System.Threading.Tasks.Task * System.Threading.Tasks.Task -> System.Threading.Tasks.Task<System.Threading.Tasks.Task>Public Shared Function WhenAny (task1 As Task, task2 As Task) As Task(Of Task)Paramètres
- task1
- Task
Première tâche à attendre pour l’achèvement.
- task2
- Task
Deuxième tâche à attendre pour l’achèvement.
Retours
Nouvelle tâche qui représente l’achèvement de l’une des tâches fournies. Sa Result est la tâche qui s’est terminée en premier.
Exceptions
task1 ou task2 était null.
Remarques
La tâche retournée se termine lorsque l’une des tâches fournies est terminée. La tâche retournée se termine toujours dans l’état RanToCompletion avec son Result défini sur la première tâche à terminer. La valeur de résultat est true même si la première tâche à effectuer se termine dans l’état Canceled ou Faulted.
S’applique à
WhenAny(Task[])
- Source:
- Task.cs
- Source:
- Task.cs
- Source:
- Task.cs
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
public:
static System::Threading::Tasks::Task<System::Threading::Tasks::Task ^> ^ WhenAny(... cli::array <System::Threading::Tasks::Task ^> ^ tasks);public static System.Threading.Tasks.Task<System.Threading.Tasks.Task> WhenAny (params System.Threading.Tasks.Task[] tasks);static member WhenAny : System.Threading.Tasks.Task[] -> System.Threading.Tasks.Task<System.Threading.Tasks.Task>Public Shared Function WhenAny (ParamArray tasks As Task()) As Task(Of Task)Paramètres
- tasks
- Task[]
Tâches à attendre pour l’achèvement.
Retours
Tâche qui représente l’achèvement de l’une des tâches fournies. Le résultat de la tâche de retour est la tâche qui s’est terminée.
Exceptions
L’argument tasks a été null.
Le tableau tasks contenait une tâche Null ou était vide.
Remarques
La tâche retournée se termine lorsque l’une des tâches fournies est terminée. La tâche retournée se termine toujours dans l’état RanToCompletion avec son Result défini sur la première tâche à terminer. Cela est vrai même si la première tâche à effectuer se termine dans l’état Canceled ou Faulted.
S’applique à
WhenAny(ReadOnlySpan<Task>)
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
public:
static System::Threading::Tasks::Task<System::Threading::Tasks::Task ^> ^ WhenAny(ReadOnlySpan<System::Threading::Tasks::Task ^> tasks);public static System.Threading.Tasks.Task<System.Threading.Tasks.Task> WhenAny (scoped ReadOnlySpan<System.Threading.Tasks.Task> tasks);static member WhenAny : ReadOnlySpan<System.Threading.Tasks.Task> -> System.Threading.Tasks.Task<System.Threading.Tasks.Task>Public Shared Function WhenAny (tasks As ReadOnlySpan(Of Task)) As Task(Of Task)Paramètres
- tasks
- ReadOnlySpan<Task>
Tâches à attendre pour l’achèvement.
Retours
Tâche qui représente l’achèvement de l’une des tâches fournies. Le résultat de la tâche renvoyée est la tâche qui s’est terminée.
Exceptions
Le tableau tasks contient une tâche null ou est vide.
Remarques
La tâche retournée se termine lorsque l’une des tâches fournies est terminée. La tâche retournée se termine toujours dans l’état RanToCompletion avec son jeu de résultats sur la première tâche à terminer. Il s’agit true même si la première tâche à effectuer se termine dans l’état Annulé ou Défectueux.
S’applique à
WhenAny(IEnumerable<Task>)
- Source:
- Task.cs
- Source:
- Task.cs
- Source:
- Task.cs
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
public:
static System::Threading::Tasks::Task<System::Threading::Tasks::Task ^> ^ WhenAny(System::Collections::Generic::IEnumerable<System::Threading::Tasks::Task ^> ^ tasks);public static System.Threading.Tasks.Task<System.Threading.Tasks.Task> WhenAny (System.Collections.Generic.IEnumerable<System.Threading.Tasks.Task> tasks);static member WhenAny : seq<System.Threading.Tasks.Task> -> System.Threading.Tasks.Task<System.Threading.Tasks.Task>Public Shared Function WhenAny (tasks As IEnumerable(Of Task)) As Task(Of Task)Paramètres
- tasks
- IEnumerable<Task>
Tâches à attendre pour l’achèvement.
Retours
Tâche qui représente l’achèvement de l’une des tâches fournies. Le résultat de la tâche de retour est la tâche qui s’est terminée.
Exceptions
L’argument tasks était null.
Le tableau tasks contenait une tâche Null ou était vide.
Remarques
La tâche retournée se termine lorsque l’une des tâches fournies est terminée. La tâche retournée se termine toujours dans l’état RanToCompletion avec son jeu de résultats sur la première tâche à terminer. Cela est vrai même si la première tâche à effectuer se termine dans l’état Canceled ou Faulted.
S’applique à
WhenAny<TResult>(IEnumerable<Task<TResult>>)
- Source:
- Task.cs
- Source:
- Task.cs
- Source:
- Task.cs
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
public:
generic <typename TResult>
static System::Threading::Tasks::Task<System::Threading::Tasks::Task<TResult> ^> ^ WhenAny(System::Collections::Generic::IEnumerable<System::Threading::Tasks::Task<TResult> ^> ^ tasks);public static System.Threading.Tasks.Task<System.Threading.Tasks.Task<TResult>> WhenAny<TResult> (System.Collections.Generic.IEnumerable<System.Threading.Tasks.Task<TResult>> tasks);static member WhenAny : seq<System.Threading.Tasks.Task<'Result>> -> System.Threading.Tasks.Task<System.Threading.Tasks.Task<'Result>>Public Shared Function WhenAny(Of TResult) (tasks As IEnumerable(Of Task(Of TResult))) As Task(Of Task(Of TResult))Paramètres de type
- TResult
Type de la tâche terminée.
Paramètres
- tasks
- IEnumerable<Task<TResult>>
Tâches à attendre pour l’achèvement.
Retours
Tâche qui représente l’achèvement de l’une des tâches fournies. Le résultat de la tâche de retour est la tâche qui s’est terminée.
Exceptions
L’argument tasks était null.
Le tableau tasks contenait une tâche Null ou était vide.
Remarques
La tâche retournée se termine lorsque l’une des tâches fournies est terminée. La tâche retournée se termine toujours dans l’état RanToCompletion avec son Result défini sur la première tâche à terminer. Cela est vrai même si la première tâche à effectuer se termine dans l’état Canceled ou Faulted.
S’applique à
WhenAny<TResult>(ReadOnlySpan<Task<TResult>>)
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
public:
generic <typename TResult>
static System::Threading::Tasks::Task<System::Threading::Tasks::Task<TResult> ^> ^ WhenAny(ReadOnlySpan<System::Threading::Tasks::Task<TResult> ^> tasks);public static System.Threading.Tasks.Task<System.Threading.Tasks.Task<TResult>> WhenAny<TResult> (scoped ReadOnlySpan<System.Threading.Tasks.Task<TResult>> tasks);static member WhenAny : ReadOnlySpan<System.Threading.Tasks.Task<'Result>> -> System.Threading.Tasks.Task<System.Threading.Tasks.Task<'Result>>Public Shared Function WhenAny(Of TResult) (tasks As ReadOnlySpan(Of Task(Of TResult))) As Task(Of Task(Of TResult))Paramètres de type
- TResult
Paramètres
- tasks
- ReadOnlySpan<Task<TResult>>
Tâches à attendre pour l’achèvement.
Retours
Tâche qui représente l’achèvement de l’une des tâches fournies. Le résultat de la tâche renvoyée est la tâche qui s’est terminée.
Exceptions
Le tableau tasks contient une tâche null ou est vide.
Remarques
La tâche retournée se termine lorsque l’une des tâches fournies est terminée. La tâche retournée se termine toujours dans l’état RanToCompletion avec son jeu de résultats sur la première tâche à terminer. Il s’agit true même si la première tâche à effectuer se termine dans l’état Annulé ou Défectueux.
S’applique à
WhenAny<TResult>(Task<TResult>[])
- Source:
- Task.cs
- Source:
- Task.cs
- Source:
- Task.cs
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
public:
generic <typename TResult>
static System::Threading::Tasks::Task<System::Threading::Tasks::Task<TResult> ^> ^ WhenAny(... cli::array <System::Threading::Tasks::Task<TResult> ^> ^ tasks);public static System.Threading.Tasks.Task<System.Threading.Tasks.Task<TResult>> WhenAny<TResult> (params System.Threading.Tasks.Task<TResult>[] tasks);static member WhenAny : System.Threading.Tasks.Task<'Result>[] -> System.Threading.Tasks.Task<System.Threading.Tasks.Task<'Result>>Public Shared Function WhenAny(Of TResult) (ParamArray tasks As Task(Of TResult)()) As Task(Of Task(Of TResult))Paramètres de type
- TResult
Type de la tâche terminée.
Paramètres
- tasks
- Task<TResult>[]
Tâches à attendre pour l’achèvement.
Retours
Tâche qui représente l’achèvement de l’une des tâches fournies. Le résultat de la tâche de retour est la tâche qui s’est terminée.
Exceptions
L’argument tasks a été null.
Le tableau tasks contenait une tâche Null ou était vide.
Remarques
La tâche retournée se termine lorsque l’une des tâches fournies est terminée. La tâche retournée se termine toujours dans l’état RanToCompletion avec son Result défini sur la première tâche à terminer. Cela est vrai même si la première tâche à effectuer se termine dans l’état Canceled ou Faulted.
S’applique à
WhenAny<TResult>(Task<TResult>, Task<TResult>)
- Source:
- Task.cs
- Source:
- Task.cs
- Source:
- Task.cs
Crée une tâche qui se termine lorsque l’une des tâches fournies est terminée.
public:
generic <typename TResult>
static System::Threading::Tasks::Task<System::Threading::Tasks::Task<TResult> ^> ^ WhenAny(System::Threading::Tasks::Task<TResult> ^ task1, System::Threading::Tasks::Task<TResult> ^ task2);public static System.Threading.Tasks.Task<System.Threading.Tasks.Task<TResult>> WhenAny<TResult> (System.Threading.Tasks.Task<TResult> task1, System.Threading.Tasks.Task<TResult> task2);static member WhenAny : System.Threading.Tasks.Task<'Result> * System.Threading.Tasks.Task<'Result> -> System.Threading.Tasks.Task<System.Threading.Tasks.Task<'Result>>Public Shared Function WhenAny(Of TResult) (task1 As Task(Of TResult), task2 As Task(Of TResult)) As Task(Of Task(Of TResult))Paramètres de type
- TResult
Type du résultat de la tâche retournée.
Paramètres
- task1
- Task<TResult>
Première tâche à attendre pour l’achèvement.
- task2
- Task<TResult>
Deuxième tâche à attendre pour l’achèvement.
Retours
Tâche qui représente l’achèvement de l’une des tâches fournies. La TResult de la tâche retournée est la tâche qui s’est terminée en premier.
Exceptions
task1 ou task2 était null.
Remarques
La tâche retournée se termine lorsque l’une des tâches fournies est terminée. La tâche retournée se termine toujours dans l’état RanToCompletion avec son Result défini sur la première tâche à terminer. La valeur de résultat est true même si la première tâche à effectuer se termine dans l’état Canceled ou Faulted.
Pourboire
Dans chaque version surchargée de Task.WhenAny() lorsque cette méthode retourne la première tâche terminée, les autres tâches continuent à s’exécuter jusqu’à l’achèvement, même l’une d’entre elles terminée dans l’état Canceled ou Faulted. Par conséquent, si ce comportement n’est pas souhaité, vous pouvez annuler toutes les tâches restantes une fois la première tâche terminée.
S’applique à
Commentaires
Prochainement : Tout au long de l'année 2024, nous supprimerons progressivement les GitHub Issues en tant que mécanisme de retour d'information pour le contenu et nous les remplacerons par un nouveau système de retour d'information. Pour plus d’informations, voir: https://aka.ms/ContentUserFeedback.
Soumettre et afficher des commentaires pour