Task.WaitAny Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Aguarda até que todos os objetos Task fornecidos tenham concluído a execução.
Sobrecargas
| WaitAny(Task[]) |
Aguarda até que todos os objetos Task fornecidos tenham concluído a execução. |
| WaitAny(Task[], Int32) |
Aguarda qualquer um dos objetos Task fornecidos concluírem a execução dentro de um número especificado de milissegundos. |
| WaitAny(Task[], CancellationToken) |
Aguarda até que os objetos Task fornecidos tenham concluído a execução, a menos que a espera seja cancelada. |
| WaitAny(Task[], TimeSpan) |
Aguarda algum dos objetos Task fornecidos concluir a execução em um intervalo especificado. |
| WaitAny(Task[], Int32, CancellationToken) |
Aguarda alguns dos objetos Task fornecidos concluírem a execução em um número especificado de milissegundos ou até que o token de cancelamento seja cancelado. |
WaitAny(Task[])
- Origem:
- Task.cs
- Origem:
- Task.cs
- Origem:
- Task.cs
Aguarda até que todos os objetos Task fornecidos tenham concluído 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[] -> intPublic Shared Function WaitAny (ParamArray tasks As Task()) As IntegerParâmetros
Retornos
O índice do objeto Task concluído na matriz tasks.
Exceções
O Task foi descartado.
O argumento tasks é null.
O argumento tasks contém um elemento nulo.
Exemplos
O exemplo a seguir inicia cinco tarefas, cada uma com suspensão mínima de 50 milissegundos ou um máximo de 1.050 milissegundos. Em WaitAny seguida, o método aguarda a conclusão de qualquer uma das tarefas. O exemplo exibe a ID da tarefa que encerrou a espera, bem como a status 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
Aplica-se a
WaitAny(Task[], Int32)
- Origem:
- Task.cs
- Origem:
- Task.cs
- Origem:
- Task.cs
Aguarda qualquer um dos objetos Task fornecidos concluírem 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 -> intPublic Shared Function WaitAny (tasks As Task(), millisecondsTimeout As Integer) As IntegerParâmetros
- millisecondsTimeout
- Int32
O número de milissegundos para aguardar ou Infinite (- 1) para aguardar indefinidamente.
Retornos
O índice da tarefa concluída no argumento da matriz tasks ou -1 se o tempo limite ocorreu.
Exceções
O Task foi descartado.
O argumento tasks é null.
millisecondsTimeout é um número negativo diferente de -1, que representa um tempo limite infinito.
O argumento tasks contém um elemento nulo.
Aplica-se a
WaitAny(Task[], CancellationToken)
- Origem:
- Task.cs
- Origem:
- Task.cs
- Origem:
- Task.cs
Aguarda até que os objetos Task fornecidos tenham concluído 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 -> intPublic Shared Function WaitAny (tasks As Task(), cancellationToken As CancellationToken) As IntegerParâmetros
- cancellationToken
- CancellationToken
Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.
Retornos
O índice da tarefa concluída no argumento da matriz tasks.
Exceções
O Task foi descartado.
O argumento tasks é null.
O argumento tasks contém um elemento nulo.
O cancellationToken foi cancelado.
Aplica-se a
WaitAny(Task[], TimeSpan)
- Origem:
- Task.cs
- Origem:
- Task.cs
- Origem:
- Task.cs
Aguarda algum dos objetos Task fornecidos concluir a execução em um intervalo 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 -> intPublic Shared Function WaitAny (tasks As Task(), timeout As TimeSpan) As IntegerParâmetros
- timeout
- TimeSpan
Um TimeSpan que representa o número de milissegundos para aguardar ou um TimeSpan que representa -1 milissegundos para aguardar indefinidamente.
Retornos
O índice da tarefa concluída no argumento da matriz tasks ou -1 se o tempo limite ocorreu.
Exceções
O Task foi descartado.
O argumento tasks é null.
A propriedade TotalMilliseconds do argumento timeout é um número negativo diferente de -1, que representa um tempo limite infinito.
- ou -
A TotalMilliseconds propriedade do timeout argumento é maior que Int32.MaxValue.
O argumento tasks contém um elemento nulo.
Aplica-se a
WaitAny(Task[], Int32, CancellationToken)
- Origem:
- Task.cs
- Origem:
- Task.cs
- Origem:
- Task.cs
Aguarda alguns dos objetos Task fornecidos concluírem a execução em um número especificado de milissegundos ou até que o 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 -> intPublic Shared Function WaitAny (tasks As Task(), millisecondsTimeout As Integer, cancellationToken As CancellationToken) As IntegerParâmetros
- millisecondsTimeout
- Int32
O número de milissegundos para aguardar ou Infinite (- 1) para aguardar indefinidamente.
- cancellationToken
- CancellationToken
Um CancellationToken a ser observado ao aguardar a conclusão da tarefa.
Retornos
O índice da tarefa concluída no argumento da matriz tasks ou -1 se o tempo limite ocorreu.
Exceções
O Task foi descartado.
O argumento tasks é null.
millisecondsTimeout é um número negativo diferente de -1, que representa um tempo limite infinito.
O argumento tasks contém um elemento nulo.
O cancellationToken foi cancelado.
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de