Task.WaitAny Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Espera que qualquer um dos objetos fornecidos Task complete a execução.
Sobrecargas
| Name | Description |
|---|---|
| WaitAny(Task[], Int32, CancellationToken) |
Aguarda que qualquer um dos objetos fornecidos Task complete a execução dentro de um número especificado de milissegundos ou até que um token de cancelamento seja cancelado. |
| WaitAny(Task[], TimeSpan) |
Aguarda que qualquer um dos objetos fornecidos Task complete a execução dentro de um intervalo de tempo especificado. |
| WaitAny(Task[], Int32) |
Aguarda que qualquer um dos objetos fornecidos Task complete a execução dentro de um número especificado de milissegundos. |
| WaitAny(Task[], CancellationToken) |
Espera que qualquer um dos objetos fornecidos Task conclua a execução, a menos que a espera seja cancelada. |
| WaitAny(Task[]) |
Espera que qualquer um dos objetos fornecidos Task complete a execução. |
WaitAny(Task[], Int32, CancellationToken)
Aguarda que qualquer um dos objetos fornecidos Task complete a execução dentro de um número especificado de milissegundos ou até que um token de cancelamento seja cancelado.
public:
static int WaitAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, int millisecondsTimeout, System::Threading::CancellationToken cancellationToken);
public static int WaitAny(System.Threading.Tasks.Task[] tasks, int millisecondsTimeout, System.Threading.CancellationToken cancellationToken);
static member WaitAny : System.Threading.Tasks.Task[] * int * System.Threading.CancellationToken -> int
Public Shared Function WaitAny (tasks As Task(), millisecondsTimeout As Integer, cancellationToken As CancellationToken) As Integer
Parâmetros
- millisecondsTimeout
- Int32
O número de milissegundos para esperar, ou Infinite (-1) para esperar indefinidamente.
- cancellationToken
- CancellationToken
A CancellationToken para observar enquanto espera que uma tarefa seja concluída.
Devoluções
O índice da tarefa concluída no argumento tasks do array, ou -1 se o timeout ocorreu.
Exceções
O Task foi descartado.
O tasks argumento é null.
millisecondsTimeout é um número negativo diferente de -1, o que representa um tempo limite infinito.
O tasks argumento contém um elemento nulo.
O cancellationToken foi cancelado.
Aplica-se a
WaitAny(Task[], TimeSpan)
Aguarda que qualquer um dos objetos fornecidos Task complete a execução dentro de um intervalo de tempo especificado.
public:
static int WaitAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, TimeSpan timeout);
public static int WaitAny(System.Threading.Tasks.Task[] tasks, TimeSpan timeout);
static member WaitAny : System.Threading.Tasks.Task[] * TimeSpan -> int
Public Shared Function WaitAny (tasks As Task(), timeout As TimeSpan) As Integer
Parâmetros
- timeout
- TimeSpan
A TimeSpan que representa o número de milissegundos para esperar, ou a TimeSpan que representa -1 milissegundos para esperar indefinidamente.
Devoluções
O índice da tarefa concluída no argumento tasks do array, ou -1 se o timeout ocorreu.
Exceções
O Task foi descartado.
O tasks argumento é null.
A TotalMilliseconds propriedade do timeout argumento é um número negativo diferente de -1, o que representa um time-out infinito.
-ou-
A TotalMilliseconds propriedade do timeout argumento é maior do que Int32.MaxValue.
O tasks argumento contém um elemento nulo.
Aplica-se a
WaitAny(Task[], Int32)
Aguarda que qualquer um dos objetos fornecidos Task complete a execução dentro de um número especificado de milissegundos.
public:
static int WaitAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, int millisecondsTimeout);
public static int WaitAny(System.Threading.Tasks.Task[] tasks, int millisecondsTimeout);
static member WaitAny : System.Threading.Tasks.Task[] * int -> int
Public Shared Function WaitAny (tasks As Task(), millisecondsTimeout As Integer) As Integer
Parâmetros
- millisecondsTimeout
- Int32
O número de milissegundos para esperar, ou Infinite (-1) para esperar indefinidamente.
Devoluções
O índice da tarefa concluída no argumento tasks do array, ou -1 se o timeout ocorreu.
Exceções
O Task foi descartado.
O tasks argumento é null.
millisecondsTimeout é um número negativo diferente de -1, o que representa um tempo limite infinito.
O tasks argumento contém um elemento nulo.
Aplica-se a
WaitAny(Task[], CancellationToken)
Espera que qualquer um dos objetos fornecidos Task conclua a execução, a menos que a espera seja cancelada.
public:
static int WaitAny(cli::array <System::Threading::Tasks::Task ^> ^ tasks, System::Threading::CancellationToken cancellationToken);
public static int WaitAny(System.Threading.Tasks.Task[] tasks, System.Threading.CancellationToken cancellationToken);
static member WaitAny : System.Threading.Tasks.Task[] * System.Threading.CancellationToken -> int
Public Shared Function WaitAny (tasks As Task(), cancellationToken As CancellationToken) As Integer
Parâmetros
- cancellationToken
- CancellationToken
A CancellationToken para observar enquanto espera que uma tarefa seja concluída.
Devoluções
O índice da tarefa concluída no argumento tasks do array.
Exceções
O Task foi descartado.
O tasks argumento é null.
O tasks argumento contém um elemento nulo.
O cancellationToken foi cancelado.
Aplica-se a
WaitAny(Task[])
Espera que qualquer um dos objetos fornecidos Task complete a execução.
public:
static int WaitAny(... cli::array <System::Threading::Tasks::Task ^> ^ tasks);
public static int WaitAny(params System.Threading.Tasks.Task[] tasks);
static member WaitAny : System.Threading.Tasks.Task[] -> int
Public Shared Function WaitAny (ParamArray tasks As Task()) As Integer
Parâmetros
Devoluções
O índice do objeto concluído Task na tasks matriz.
Exceções
O Task foi descartado.
O tasks argumento é null.
O tasks argumento contém um elemento nulo.
Exemplos
O exemplo seguinte lança cinco tarefas, cada uma com suspensão de pelo menos 50 milissegundos ou no máximo 1.050 milissegundos. O WaitAny método espera então que alguma das tarefas seja concluída. O exemplo mostra o ID da tarefa que terminou a espera, bem como o estado atual de todas as tarefas.
using System;
using System.Threading;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
Task[] tasks = new Task[5];
for (int ctr = 0; ctr <= 4; ctr++) {
int factor = ctr;
tasks[ctr] = Task.Run(() => Thread.Sleep(factor * 250 + 50));
}
int index = Task.WaitAny(tasks);
Console.WriteLine("Wait ended because task #{0} completed.",
tasks[index].Id);
Console.WriteLine("\nCurrent Status of Tasks:");
foreach (var t in tasks)
Console.WriteLine(" Task {0}: {1}", t.Id, t.Status);
}
}
// The example displays output like the following:
// Wait ended because task #1 completed.
//
// Current Status of Tasks:
// Task 1: RanToCompletion
// Task 2: Running
// Task 3: Running
// Task 4: Running
// Task 5: Running
open System.Threading
open System.Threading.Tasks
let tasks =
[| for factor = 0 to 4 do
Task.Run(fun () -> Thread.Sleep(factor * 250 + 50)) |]
let index = Task.WaitAny tasks
printfn $"Wait ended because task #{tasks[index].Id} completed."
printfn "\nCurrent Status of Tasks:"
for t in tasks do
printfn $" Task {t.Id}: {t.Status}"
// The example displays output like the following:
// Wait ended because task #1 completed.
//
// Current Status of Tasks:
// Task 1: RanToCompletion
// Task 2: Running
// Task 3: Running
// Task 4: Running
// Task 5: Running
Imports System.Threading
Imports System.Threading.Tasks
Module Example
Public Sub Main()
Dim tasks(4) As Task
For ctr As Integer = 0 To 4
Dim factor As Integer = ctr
tasks(ctr) = Task.Run(Sub() Thread.Sleep(factor * 250 + 50))
Next
Dim index As Integer = Task.WaitAny(tasks)
Console.WriteLine("Wait ended because task #{0} completed.",
tasks(index).Id)
Console.WriteLine()
Console.WriteLine("Current Status of Tasks:")
For Each t In tasks
Console.WriteLine(" Task {0}: {1}", t.Id, t.Status)
Next
End Sub
End Module
' The example displays output like the following:
' Wait ended because task #1 completed.
'
' Current Status of Tasks:
' Task 1: RanToCompletion
' Task 2: Running
' Task 3: Running
' Task 4: Running
' Task 5: Running