Start Multiple Async Tasks and Process Them As They Complete (C#)

By using Task.WhenAny, you can start multiple tasks at the same time and process them one by one as they’re completed rather than process them in the order in which they're started.

The following example uses a query to create a collection of tasks. Each task downloads the contents of a specified website. In each iteration of a while loop, an awaited call to WhenAny returns the task in the collection of tasks that finishes its download first. That task is removed from the collection and processed. The loop repeats until the collection contains no more tasks.


To run the examples, you must have Visual Studio (2012 or newer) and the .NET Framework 4.5 or newer installed on your computer.

Download an example solution

You can download the complete Windows Presentation Foundation (WPF) project from Async Sample: Fine Tuning Your Application and then follow these steps.


If you don't want to download the project, you can review the MainWindow.xaml.cs file at the end of this topic instead.

  1. Extract the files that you downloaded from the .zip file, and then start Visual Studio.

  2. On the menu bar, choose File > Open > Project/Solution.

  3. In the Open Project dialog box, open the folder that holds the sample code you downloaded, and then open the solution (.sln) file for AsyncFineTuningCS.

  4. In Solution Explorer, open the shortcut menu for the ProcessTasksAsTheyFinish project, and then choose Set as StartUp Project.

  5. Choose the F5 key to run the program (or, press Ctrl+F5 keys to run the program without debugging it).

  6. Run the project several times to verify that the downloaded lengths don't always appear in the same order.

Create the program yourself

This example adds to the code that’s developed in Cancel Remaining Async Tasks after One Is Complete (C#), and it uses the same UI.

To build the example yourself, step by step, follow the instructions in the Downloading the Example section, but set CancelAfterOneTask as the startup project. Add the changes in this topic to the AccessTheWebAsync method in that project. The changes are marked with asterisks.

The CancelAfterOneTask project already includes a query that, when executed, creates a collection of tasks. Each call to ProcessURLAsync in the following code returns a Task<TResult>, where TResult is an integer:

IEnumerable<Task<int>> downloadTasksQuery = from url in urlList select ProcessURL(url, client, ct);

In the MainWindow.xaml.cs file of the project, make the following changes to the AccessTheWebAsync method.

  • Execute the query by applying Enumerable.ToList instead of ToArray.

    List<Task<int>> downloadTasks = downloadTasksQuery.ToList();
  • Add a while loop that performs the following steps for each task in the collection:

    1. Awaits a call to WhenAny to identify the first task in the collection to finish its download.

      Task<int> firstFinishedTask = await Task.WhenAny(downloadTasks);
    2. Removes that task from the collection.

    3. Awaits firstFinishedTask, which is returned by a call to ProcessURLAsync. The firstFinishedTask variable is a Task<TResult> where TReturn is an integer. The task is already complete, but you await it to retrieve the length of the downloaded website, as the following example shows.

      int length = await firstFinishedTask;
      resultsTextBox.Text += $"\r\nLength of the download:  {length}";

Run the program several times to verify that the downloaded lengths don't always appear in the same order.


You can use WhenAny in a loop, as described in the example, to solve problems that involve a small number of tasks. However, other approaches are more efficient if you have a large number of tasks to process. For more information and examples, see Processing tasks as they complete.

Complete example

The following code is the complete text of the MainWindow.xaml.cs file for the example. Asterisks mark the elements that were added for this example. Also, take note that you must add a reference for System.Net.Http.

You can download the project from Async Sample: Fine Tuning Your Application.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

// Add a using directive and a reference for System.Net.Http.
using System.Net.Http;

// Add the following using directive.
using System.Threading;

namespace ProcessTasksAsTheyFinish
    public partial class MainWindow : Window
        // Declare a System.Threading.CancellationTokenSource.
        CancellationTokenSource cts;

        public MainWindow()

        private async void startButton_Click(object sender, RoutedEventArgs e)

            // Instantiate the CancellationTokenSource.
            cts = new CancellationTokenSource();

                await AccessTheWebAsync(cts.Token);
                resultsTextBox.Text += "\r\nDownloads complete.";
            catch (OperationCanceledException)
                resultsTextBox.Text += "\r\nDownloads canceled.\r\n";
            catch (Exception)
                resultsTextBox.Text += "\r\nDownloads failed.\r\n";

            cts = null;

        private void cancelButton_Click(object sender, RoutedEventArgs e)
            if (cts != null)

        async Task AccessTheWebAsync(CancellationToken ct)
            HttpClient client = new HttpClient();

            // Make a list of web addresses.
            List<string> urlList = SetUpURLList();

            // ***Create a query that, when executed, returns a collection of tasks.
            IEnumerable<Task<int>> downloadTasksQuery =
                from url in urlList select ProcessURL(url, client, ct);

            // ***Use ToList to execute the query and start the tasks.
            List<Task<int>> downloadTasks = downloadTasksQuery.ToList();

            // ***Add a loop to process the tasks one at a time until none remain.
            while (downloadTasks.Count > 0)
                    // Identify the first task that completes.
                    Task<int> firstFinishedTask = await Task.WhenAny(downloadTasks);

                    // ***Remove the selected task from the list so that you don't
                    // process it more than once.

                    // Await the completed task.
                    int length = await firstFinishedTask;
                    resultsTextBox.Text += $"\r\nLength of the download:  {length}";

        private List<string> SetUpURLList()
            List<string> urls = new List<string>
            return urls;

        async Task<int> ProcessURL(string url, HttpClient client, CancellationToken ct)
            // GetAsync returns a Task<HttpResponseMessage>.
            HttpResponseMessage response = await client.GetAsync(url, ct);

            // Retrieve the website contents from the HttpResponseMessage.
            byte[] urlContents = await response.Content.ReadAsByteArrayAsync();

            return urlContents.Length;

// Sample Output:

// Length of the download:  226093
// Length of the download:  412588
// Length of the download:  175490
// Length of the download:  204890
// Length of the download:  158855
// Length of the download:  145790
// Length of the download:  44908
// Downloads complete.

See also