.NET幫助

C# Task.Run（對於開發者的運行原理）

Q: 如何在 C# 中執行非同步任務？

您可以使用 Task.Run 方法在執行緒池中的獨立執行緒上非同步執行 CPU 密集型或 I/O 密集型操作。這有助於防止阻塞主執行緒並改善應用程式的響應性。

Q: 開發者如何使用 Task.Run 來同時管理多個任務？

開發者可以使用 Task.Run 發起多個任務，並使用 Task.WhenAll 來等待它們的完成。這允許高效地同時執行獨立操作。

更新日期:7月 28, 2025

在本文中，我們深入探討 C# 中的 Task.Run 基礎知識，這是一個在非同步程式設計中功能強大的構造。非同步程式設計對於編寫響應迅速且高效的應用程式至關重要，尤其是在處理可能阻塞應用程式執行的操作時，例如網路呼叫或強集計算任務。 Task.Run 是常用的非同步方法之一，用於將這些操作卸載到背景執行緒，以提高應用程式的效能和回應速度。我們將探索 Task.Run 方法及其與 IronPDF 庫的綜合功能的結合使用。

瞭解 Task.Run

Task.Run 是 .NET Core 提供的一種調用方法，允許開發人員在執行緒池中的另一個執行緒上非同步執行 CPU 綁定代碼或 I/O 綁定操作。此方法有利於通過使用非同步執行緒來執行長時間運行的操作，以保持您的 UI 執行緒的響應性。它簡化了在不同執行緒上啟動新的非同步操作，然後可以使用 await 關鍵字等待。

Task.Run 的基本用法

考慮一個需要執行長時間計算的簡單範例。您可以使用 Task.Run 在背景中處理這個操作，而不是直接在主執行緒上運行，這將阻塞 UI:

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}");
}

Imports System
Imports System.Threading.Tasks

Shared Async Function PerformComputation() As Task
	Dim result As Integer = Await Task.Run(Function()
		Dim sum As Integer = 0
		For i As Integer = 0 To 999999
			sum += i
		Next i
		Return sum
	End Function)
	Console.WriteLine($"The result is {result}")
End Function

$vbLabelText $csharpLabel

輸出

C# Task.Run (為開發人員工作原理)：圖 1 - 上述代碼的控制台輸出

在上述範例中，Task.Run 内的 lambda 表達式代表一段計算大範圍數字的 CPU 綁定代碼。通過使用 Task.Run，此計算被卸載到背景執行緒，使主執行緒保持響應性。使用 await 任務關鍵字非同步等待任務完成，而不阻塞目前的執行緒。

深入探討非同步任務和執行緒

當您調用 Task.Run 時，.NET Framework 為指定的任務分配一個來自執行緒池的執行緒。這樣可以避免為每個任務創建新執行緒的開銷，有助於更有效地利用系統資源。執行緒池將為您的應用程式管理一組工作執行緒，這些執行緒可以在多個核心上同時運行多個任務。

處理多個任務

您可以使用 Task.Run 來同時運行一個新任務，這對于需要同時執行多個獨立操作的應用程式非常有益。以下是如何啟動多個任務的示例：

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;
}

Imports System
Imports System.Threading.Tasks

Shared Async Function HandleMultipleTasks() As Task
	Dim task1 As Task(Of Integer) = Task.Run(Function()
		Return PerformLongRunningWork("Task 1")
	End Function)

	Dim task2 As Task(Of Integer) = Task.Run(Function()
		Return PerformLongRunningWork("Task 2")
	End Function)

	' Wait for tasks to finish and print the results
	Dim results() As Integer = Await Task.WhenAll(task1, task2)
	Console.WriteLine($"Results of Task 1: {results(0)}, Task 2: {results(1)}")
End Function

Shared Function PerformLongRunningWork(ByVal taskName As String) As Integer
	Dim result As Integer = 0
	For i As Integer = 0 To 499999
		result += i
	Next i
	Console.WriteLine($"{taskName} completed.")
	Return result
End Function

$vbLabelText $csharpLabel

輸出

C# Task.Run (為開發人員工作原理)：圖 2

在此範例中，HandleMultipleTasks 開始兩個非同步任務。 Task.WhenAll 方法用於等待每個非同步任務，允許它們同時運行。一旦兩個任務都完成，它就會繼續執行下一行代碼。

最佳實踐和考慮事項

儘管 Task.Run 是非同步編程中的一個有價值的工具，但明智地使用它以避免常見的陷阱，比如過度使用系統資源或導致應用程式中出現意外行為。

對 CPU 綁定操作使用 Task.Run

最好將 Task.Run 用於 CPU 綁定的工作，而不是用於 I/O 綁定的操作。對於 I/O 綁定任務，使用 .NET 庫中提供的非同步 I/O 操作。

注意使用執行緒池執行緒

請記住，Task.Run 使用執行緒池執行緒。運行過多的並發操作以耗盡這些執行緒可能會導致任務啟動時間延遲和應用程式整體性能下降。

避免同步代碼

在等待由 Task.Run 啟動的任務時，避免使用同步等待方法，如 Task.Result 或 Task.Wait 方法，因為它們可能導致死鎖，特別是在像 UI 應用這樣的環境中。

IronPDF 介紹

C# Task.Run (為開發人員工作原理)：圖 3 - IronPDF 網頁

IronPDF is a C# library that lets you generate and manage PDF 文件。它專為 .NET 開發人員設計，通過使用您已經擁有的 Web 內容來簡化 PDF 的創建，確保瀏覽器中所見即為 PDF 所得。無論是 Web、桌面還是基於服務器的應用程式，它都適用於各種 .NET 應用程序，並提供如 PDF 編輯、表單處理和安全文件創建等功能。

簡單來說，IronPDF 可讓您快速且準確地將網頁轉換為 PDF。您無需處理複雜的 API；只需用 HTML 設計您的頁面，IronPDF 將完成其餘工作。它能在不同的 .NET 平台上運行，並提供調整、安全以及與 PDF 交互的工具。

使用 Task.Run 的 IronPDF

代碼示例

以下是將 IronPDF 與 Task.Run 一起使用的 C# 簡單範例。此示例演示了如何從 HTML 內容非同步生成 PDF。這對於避免桌面應用程式中的 UI 凍結或管理 Web 應用程式中的負載特別有用：

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.");
    }
}

Imports IronPdf
Imports System.Threading.Tasks

Public Class PdfGenerator
	Public Shared Async Function CreatePdfAsync() As Task
		Dim renderer = New ChromePdfRenderer()
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is an async PDF generation.</p>"

		' Run the PDF generation in a separate task
		Dim pdf = Await Task.Run(Function() renderer.RenderHtmlAsPdf(htmlContent))

		' Save the PDF to a file
		pdf.SaveAs("asyncIronPDF.pdf")
	End Function

	' Main method to execute the PDF generation
	Public Shared Sub 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 Function() Await PdfGenerator.CreatePdfAsync()).Wait()

		' Inform the user that the PDF generation is complete
		System.Console.WriteLine("PDF generated.")
	End Sub
End Class

$vbLabelText $csharpLabel