Task.WhenAny Método

Definição

Namespace:

System.Threading.Tasks

Assembly:

System.Runtime.dll

Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas foi concluída

Sobrecargas

WhenAny(IEnumerable<Task>)	Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas foi concluída
WhenAny(Task[])	Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas foi concluída
WhenAny(Task, Task)	Cria uma tarefa que será concluída quando uma das tarefas fornecidas for finalizada.
WhenAny<TResult>(IEnumerable<Task<TResult>>)	Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas foi concluída
WhenAny<TResult>(Task<TResult>[])	Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas foi concluída
WhenAny<TResult>(Task<TResult>, Task<TResult>)	Cria uma tarefa que será concluída quando uma das tarefas fornecidas for finalizada.

WhenAny(IEnumerable<Task>)

Origem:

Task.cs

Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas foi concluída

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)

Parâmetros

tasks

IEnumerable<Task>

As tarefas para aguardar pela conclusão.

Retornos

Task<Task>

Uma tarefa que representa a conclusão de uma das tarefas fornecidas. O Resultado da tarefa de retorno é a tarefa concluída.

Exceções

ArgumentNullException

O argumento tasks é null.

ArgumentException

A matriz tasks continha uma tarefa nula ou estava vazia.

Comentários

A tarefa retornada será concluída quando qualquer uma das tarefas fornecidas for concluída. A tarefa retornada sempre terminará no RanToCompletion estado com seu Resultado definido como a primeira tarefa a ser concluída. Isso é verdadeiro mesmo se a primeira tarefa a ser concluída terminar no Canceled estado ou Faulted .

WhenAny(Task[])

Origem:

Task.cs

Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas foi concluída

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)

Parâmetros

tasks

Task[]

As tarefas para aguardar pela conclusão.

Retornos

Task<Task>

Uma tarefa que representa a conclusão de uma das tarefas fornecidas. O Resultado da tarefa de retorno é a tarefa concluída.

Exceções

ArgumentNullException

O argumento tasks era nulo.

ArgumentException

A matriz tasks continha uma tarefa nula ou estava vazia.

Comentários

A tarefa retornada será concluída quando qualquer uma das tarefas fornecidas for concluída. A tarefa retornada sempre terminará no RanToCompletion estado com seu Result definido como a primeira tarefa a ser concluída. Isso é verdadeiro mesmo se a primeira tarefa a ser concluída terminar no Canceled estado ou Faulted .

WhenAny(Task, Task)

Origem:

Task.cs

Cria uma tarefa que será concluída quando uma das tarefas fornecidas for finalizada.

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)

Parâmetros

task1

Task

A primeira tarefa a aguardar pela conclusão.

task2

Task

A segunda tarefa a aguardar pela conclusão.

Retornos

Task<Task>

Uma nova tarefa que representa a conclusão de uma das tarefas fornecidas. O Result é a tarefa que foi concluída primeiro.

Exceções

ArgumentNullException

task1 ou task2 era null.

Comentários

A tarefa retornada será concluída quando qualquer uma das tarefas fornecidas for concluída. A tarefa retornada sempre terminará no RanToCompletion estado com seu Result definido como a primeira tarefa a ser concluída. O valor do resultado será true mesmo se a primeira tarefa a ser concluída terminar no Canceled estado ou Faulted .

WhenAny<TResult>(IEnumerable<Task<TResult>>)

Origem:

Task.cs

Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas foi concluída

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))

Parâmetros de tipo

TResult

O tipo de tarefa concluída.

Parâmetros

tasks

IEnumerable<Task<TResult>>

As tarefas para aguardar pela conclusão.

Retornos

Task<Task<TResult>>

Uma tarefa que representa a conclusão de uma das tarefas fornecidas. O Resultado da tarefa de retorno é a tarefa concluída.

Exceções

ArgumentNullException

O argumento tasks é null.

ArgumentException

A matriz tasks continha uma tarefa nula ou estava vazia.

Comentários

A tarefa retornada será concluída quando qualquer uma das tarefas fornecidas for concluída. A tarefa retornada sempre terminará no RanToCompletion estado com seu Result definido como a primeira tarefa a ser concluída. Isso é verdadeiro mesmo se a primeira tarefa a ser concluída terminar no Canceled estado ou Faulted .

WhenAny<TResult>(Task<TResult>[])

Origem:

Task.cs

Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas foi concluída

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))

Parâmetros de tipo

TResult

O tipo de tarefa concluída.

Parâmetros

tasks

Task<TResult>[]

As tarefas para aguardar pela conclusão.

Retornos

Task<Task<TResult>>

Uma tarefa que representa a conclusão de uma das tarefas fornecidas. O Resultado da tarefa de retorno é a tarefa concluída.

Exceções

ArgumentNullException

O argumento tasks era nulo.

ArgumentException

A matriz tasks continha uma tarefa nula ou estava vazia.

Comentários

A tarefa retornada será concluída quando qualquer uma das tarefas fornecidas for concluída. A tarefa retornada sempre terminará no RanToCompletion estado com seu Result definido como a primeira tarefa a ser concluída. Isso é verdadeiro mesmo se a primeira tarefa a ser concluída terminar no Canceled estado ou Faulted .

WhenAny<TResult>(Task<TResult>, Task<TResult>)

Origem:

Task.cs

Cria uma tarefa que será concluída quando uma das tarefas fornecidas for finalizada.

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))

Parâmetros de tipo

TResult

O tipo do resultado da tarefa retornada.

Parâmetros

task1

Task<TResult>

A primeira tarefa a aguardar pela conclusão.

task2

Task<TResult>

A segunda tarefa a aguardar pela conclusão.

Retornos

Task<Task<TResult>>

Uma tarefa que representa a conclusão de uma das tarefas fornecidas. O TResult da tarefa retornada é a tarefa que foi concluída primeiro.

Exceções

ArgumentNullException

task1 ou task2 era null.

Comentários

A tarefa retornada será concluída quando qualquer uma das tarefas fornecidas for concluída. A tarefa retornada sempre terminará no RanToCompletion estado com seu Result definido como a primeira tarefa a ser concluída. O valor do resultado será true mesmo se a primeira tarefa a ser concluída terminar no Canceled estado ou Faulted .

Dica

Em cada versão sobrecarregada de Task.WhenAny() quando esse método retorna a primeira tarefa concluída, as outras tarefas continuarão em execução até a conclusão, mesmo qualquer uma delas concluída no Canceled estado ou Faulted . Portanto, se esse comportamento não for desejado, talvez você queira cancelar todas as tarefas restantes depois que a primeira tarefa for concluída.