Task.WhenAny Metoda

Definicja

Przestrzeń nazw:

System.Threading.Tasks

Zestaw:

System.Runtime.dll

Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.

Przeciążenia

WhenAny(IEnumerable<Task>)	Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.
WhenAny(Task[])	Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.
WhenAny(Task, Task)	Tworzy zadanie, które zostanie ukończone po zakończeniu jednego z podanych zadań.
WhenAny<TResult>(IEnumerable<Task<TResult>>)	Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.
WhenAny<TResult>(Task<TResult>[])	Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.
WhenAny<TResult>(Task<TResult>, Task<TResult>)	Tworzy zadanie, które zostanie ukończone po zakończeniu jednego z podanych zadań.

WhenAny(IEnumerable<Task>)

Źródło:

Task.cs

Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.

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)

Parametry

tasks

IEnumerable<Task>

Zadania oczekujące na ukończenie.

Zwraca

Task<Task>

Zadanie reprezentujące ukończenie jednego z dostarczonych zadań. Wynik zadania zwracanego to zadanie, które zostało ukończone.

Wyjątki

ArgumentNullException

Argumentem tasks był null.

ArgumentException

Tablica tasks zawierała zadanie o wartości null lub była pusta.

Uwagi

Zwrócone zadanie zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań. Zwrócone zadanie będzie zawsze kończyć się RanToCompletion stanem z zestawem Wyników na pierwsze zadanie do ukończenia. Jest to prawda, nawet jeśli pierwsze zadanie do wykonania zostało zakończone w Canceled stanie lub Faulted .

WhenAny(Task[])

Źródło:

Task.cs

Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.

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)

Parametry

tasks

Task[]

Zadania oczekujące na ukończenie.

Zwraca

Task<Task>

Zadanie reprezentujące ukończenie jednego z dostarczonych zadań. Wynik zadania zwracanego to zadanie, które zostało ukończone.

Wyjątki

ArgumentNullException

Argument tasks miał wartość null.

ArgumentException

Tablica tasks zawierała zadanie o wartości null lub była pusta.

Uwagi

Zwrócone zadanie zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań. Zwrócone zadanie zawsze kończy się w RanToCompletion stanie z Result ustawionym na pierwsze zadanie do wykonania. Jest to prawda, nawet jeśli pierwsze zadanie do wykonania zostało zakończone w Canceled stanie lub Faulted .

WhenAny(Task, Task)

Źródło:

Task.cs

Tworzy zadanie, które zostanie ukończone po zakończeniu jednego z podanych zadań.

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)

Parametry

task1

Task

Pierwsze zadanie czeka na zakończenie.

task2

Task

Drugie zadanie czeka na zakończenie.

Zwraca

Task<Task>

Nowe zadanie, które reprezentuje ukończenie jednego z dostarczonych zadań. Jest to Result zadanie, które zostało ukończone jako pierwsze.

Wyjątki

ArgumentNullException

task1 lub task2 był null.

Uwagi

Zwrócone zadanie zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań. Zwrócone zadanie zawsze kończy się w RanToCompletion stanie z Result ustawionym na pierwsze zadanie do wykonania. Wartość wyniku jest true nawet wtedy, gdy pierwsze zadanie do ukończenia zostało zakończone w Canceled stanie lub Faulted .

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

Źródło:

Task.cs

Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.

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

Parametry typu

TResult

Typ ukończonego zadania.

Parametry

tasks

IEnumerable<Task<TResult>>

Zadania oczekujące na ukończenie.

Zwraca

Task<Task<TResult>>

Zadanie reprezentujące ukończenie jednego z dostarczonych zadań. Wynik zadania zwracanego to zadanie, które zostało ukończone.

Wyjątki

ArgumentNullException

Argumentem tasks był null.

ArgumentException

Tablica tasks zawierała zadanie o wartości null lub była pusta.

Uwagi

Zwrócone zadanie zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań. Zwrócone zadanie zawsze kończy się w RanToCompletion stanie z Result ustawionym na pierwsze zadanie do wykonania. Jest to prawda, nawet jeśli pierwsze zadanie do wykonania zostało zakończone w Canceled stanie lub Faulted .

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

Źródło:

Task.cs

Tworzy zadanie, które zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań.

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

Parametry typu

TResult

Typ ukończonego zadania.

Parametry

tasks

Task<TResult>[]

Zadania oczekujące na ukończenie.

Zwraca

Task<Task<TResult>>

Zadanie reprezentujące ukończenie jednego z dostarczonych zadań. Wynik zadania zwracanego to zadanie, które zostało ukończone.

Wyjątki

ArgumentNullException

Argument tasks miał wartość null.

ArgumentException

Tablica tasks zawierała zadanie o wartości null lub była pusta.

Uwagi

Zwrócone zadanie zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań. Zwrócone zadanie zawsze kończy się w RanToCompletion stanie z Result ustawionym na pierwsze zadanie do wykonania. Jest to prawda, nawet jeśli pierwsze zadanie do wykonania zostało zakończone w Canceled stanie lub Faulted .

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

Źródło:

Task.cs

Tworzy zadanie, które zostanie ukończone po zakończeniu jednego z podanych zadań.

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

Parametry typu

TResult

Typ wyniku zwróconego zadania.

Parametry

task1

Task<TResult>

Pierwsze zadanie czeka na zakończenie.

task2

Task<TResult>

Drugie zadanie czeka na zakończenie.

Zwraca

Task<Task<TResult>>

Zadanie reprezentujące ukończenie jednego z dostarczonych zadań. Zwrócone zadanie TResult to zadanie, które zostało ukończone jako pierwsze.

Wyjątki

ArgumentNullException

task1 lub task2 był null.

Uwagi

Zwrócone zadanie zostanie ukończone po zakończeniu któregokolwiek z dostarczonych zadań. Zwrócone zadanie zawsze kończy się w RanToCompletion stanie z Result ustawionym na pierwsze zadanie do wykonania. Wartość wyniku jest true nawet wtedy, gdy pierwsze zadanie do ukończenia zostało zakończone w Canceled stanie lub Faulted .

Porada

W każdej przeciążonej wersji task.WhenAny(), gdy ta metoda zwraca pierwsze ukończone zadanie, inne zadania będą kontynuowane do momentu ukończenia, nawet w każdym z nich ukończonych w Canceled stanie lub Faulted . Dlatego jeśli to zachowanie nie jest pożądane, możesz anulować wszystkie pozostałe zadania po zakończeniu pierwszego zadania.