C# Task.Run (How It Works For Developers)

Consider a simple example where you need to perform a lengthy computation. Instead of running this directly on the main thread, which would block the UI, you can use Task.Run to handle it in the background:

using System;
using System.Threading.Tasks;

static async Task PerformComputation() 
{
    int result = await Task.Run(() =>
    {
        int sum = 0;
        for (int i = 0; i < 1000000; i++)
        {
            sum += i;
        }
        return sum;
    });
    Console.WriteLine($"The result is {result}");
}

using System;
using System.Threading.Tasks;

static async Task PerformComputation() 
{
    int result = await Task.Run(() =>
    {
        int sum = 0;
        for (int i = 0; i < 1000000; i++)
        {
            sum += i;
        }
        return sum;
    });
    Console.WriteLine($"The result is {result}");
}

Output

In the above example, the lambda expression inside Task.Run represents a block of CPU-bound code that sums up a large range of numbers. By using Task.Run, this computation is offloaded to a background thread, allowing the main thread to remain responsive. The await task keyword is used to asynchronously wait until the task completes, without blocking the current thread.

You can run a new task concurrently using Task.Run, which is beneficial for applications that need to perform several independent operations simultaneously. Here's how you can initiate multiple tasks:

using System;
using System.Threading.Tasks;

static async Task HandleMultipleTasks()
{
    Task<int> task1 = Task.Run(() =>
    {
        return PerformLongRunningWork("Task 1");
    });

    Task<int> task2 = Task.Run(() =>
    {
        return PerformLongRunningWork("Task 2");
    });

    // Wait for tasks to finish and print the results
    int[] results = await Task.WhenAll(task1, task2); 
    Console.WriteLine($"Results of Task 1: {results[0]}, Task 2: {results[1]}");
}

static int PerformLongRunningWork(string taskName)
{
    int result = 0;
    for (int i = 0; i < 500000; i++)
    {
        result += i;
    }
    Console.WriteLine($"{taskName} completed.");
    return result;
}

using System;
using System.Threading.Tasks;

static async Task HandleMultipleTasks()
{
    Task<int> task1 = Task.Run(() =>
    {
        return PerformLongRunningWork("Task 1");
    });

    Task<int> task2 = Task.Run(() =>
    {
        return PerformLongRunningWork("Task 2");
    });

    // Wait for tasks to finish and print the results
    int[] results = await Task.WhenAll(task1, task2); 
    Console.WriteLine($"Results of Task 1: {results[0]}, Task 2: {results[1]}");
}

static int PerformLongRunningWork(string taskName)
{
    int result = 0;
    for (int i = 0; i < 500000; i++)
    {
        result += i;
    }
    Console.WriteLine($"{taskName} completed.");
    return result;
}

Output

In this example, HandleMultipleTasks starts two asynchronous tasks. The Task.WhenAll method is used to await each asynchronous task, which allows them to run concurrently. Once both tasks are complete, it continues with the next line of code.

Code Example

Here's a simple example of using IronPDF with Task.Run in C#. This example demonstrates how to generate a PDF from HTML content asynchronously. This is particularly useful for avoiding UI freezing in desktop applications or managing the load in web applications:

using IronPdf;
using System.Threading.Tasks;

public class PdfGenerator
{
    public static async Task CreatePdfAsync()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is an async PDF generation.</p>";

        // Run the PDF generation in a separate task
        var pdf = await Task.Run(() => renderer.RenderHtmlAsPdf(htmlContent));

        // Save the PDF to a file
        pdf.SaveAs("asyncIronPDF.pdf");
    }

    // Main method to execute the PDF generation
    public static void Main()
    {
        // Set the license key for IronPDF
        License.LicenseKey = "License-Key";

        // Calling the async PDF generation method and blocking the Main thread until completion
        Task.Run(async () => await PdfGenerator.CreatePdfAsync()).Wait();

        // Inform the user that the PDF generation is complete
        System.Console.WriteLine("PDF generated.");
    }
}

using IronPdf;
using System.Threading.Tasks;

public class PdfGenerator
{
    public static async Task CreatePdfAsync()
    {
        var renderer = new ChromePdfRenderer();
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is an async PDF generation.</p>";

        // Run the PDF generation in a separate task
        var pdf = await Task.Run(() => renderer.RenderHtmlAsPdf(htmlContent));

        // Save the PDF to a file
        pdf.SaveAs("asyncIronPDF.pdf");
    }

    // Main method to execute the PDF generation
    public static void Main()
    {
        // Set the license key for IronPDF
        License.LicenseKey = "License-Key";

        // Calling the async PDF generation method and blocking the Main thread until completion
        Task.Run(async () => await PdfGenerator.CreatePdfAsync()).Wait();

        // Inform the user that the PDF generation is complete
        System.Console.WriteLine("PDF generated.");
    }
}

Output

This example encapsulates the PDF generation within a Task, making it suitable for applications that require non-blocking operations.