C#Task.Wait方法详解-国庆期间有人问起的问题

原创最新推荐文章于 2026-07-16 11:28:48 发布 4.3k 阅读 AI写同款

收录于

BlazorComponent

码龄5年墨衍会员 · AI 创作全网分发

384粉丝14篇原创

关注

c# 任务（Task）以及异步 await(等待) 、Async（异步） Task出现之前，微软的多线程处理方式有：Thread→ThreadPool→委托的异步调用，虽然也可以基本业务需要的多线程场景，但它们在多个线程的等待处理方面、资源占用方面、线程延续和阻塞方面、线程的取消方面等都显得比较笨拙，ThreadPool相比Thread来说具备了很多优势，但是ThreadPool却又存在一些使用上的不方便。Task.WhenAny(tasks.ToArray()).ContinueWith(x => Console.WriteLine("某个Task执行完毕")); 阅读详情

AI摘要

本文详细介绍了C#中的Task.Wait方法，包括其基本用法、不同重载形式（无参、带超时和CancellationToken），以及如何使用CancellationToken实现任务的取消。着重强调了超时时间和任务管理的重要性。

在C#中，Task.Wait方法是用于等待一个异步任务完成的方法。它会阻塞当前线程，直到任务完成或超时。

Task.Wait方法有几个重载形式，最常用的形式是不带参数的Wait()方法。这个方法会一直等待，直到任务完成为止。如果任务已经完成，那么Wait()方法会立即返回；如果任务尚未完成，当前线程将被阻塞，直到任务完成。

另外，Wait()方法还有一个重载形式：Wait(TimeSpan timeout)。这个重载方法允许我们指定一个超时时间，如果任务在指定的时间内没有完成，Wait()方法会返回并抛出一个System.Threading.Tasks.TaskTimeoutException异常。

下面是一个示例：

static async Task Main()
{
    Task task = Task.Delay(3000); // 模拟一个耗时操作

    Console.WriteLine("任务开始执行");

    task.Wait(); // 等待任务完成

    Console.WriteLine("任务执行完毕");
}

在上面的示例中，我们创建了一个异步任务task，该任务会延迟3秒钟。然后，我们调用task.Wait()方法来等待任务完成。在任务完成之前，Wait()方法会阻塞当前线程。当任务完成后，Wait()方法返回，程序继续执行。

需要注意的是，如果在调用Wait()方法之前任务已经完成，那么Wait()方法会立即返回，不会阻塞当前线程。

此外，Task.Wait方法还有一些其他的重载形式，可以接受一个CancellationToken参数，以及一个带超时时间的TimeSpan参数等。这些重载方法提供了更多的灵活性和控制能力。

Wait(CancellationToken cancellationToken)：这个重载方法允许我们传递一个CancellationToken参数，使得可以通过取消标记来中止等待操作。如果在任务完成之前取消了cancellationToken，那么Wait()方法会立即返回，并且会抛出一个System.OperationCanceledException异常。

static async Task Main()
{
    CancellationTokenSource cts = new CancellationTokenSource();
    CancellationToken token = cts.Token;

    Task task = Task.Delay(3000, token); // 模拟一个耗时操作

    Console.WriteLine("任务开始执行");

    // 5秒后取消任务
    cts.CancelAfter(5000);

    try
    {
        task.Wait(token); // 等待任务完成并检测取消标记
        Console.WriteLine("任务执行完毕");
    }
    catch (OperationCanceledException)
    {
        Console.WriteLine("任务取消");
    }
}

这段代码使用了Task.Delay方法模拟一个耗时操作，并使用CancellationTokenSource和CancellationToken来实现任务的取消功能。

首先，我们创建了一个CancellationTokenSource对象，cts用于取消任务。
然后，通过cts.Token获取一个CancellationToken对象，token用于在等待任务完成时检测取消标记。
我们创建了一个异步任务task，利用Task.Delay方法模拟一个耗时操作，持续3秒钟。通过传递token作为参数，以便在取消标记被触发时中止任务。
在控制台输出"任务开始执行"。
使用cts.CancelAfter(5000)方法，在5秒钟后取消任务。
在try块中，我们调用task.Wait(token)方法来等待任务完成，并检测取消标记。如果任务成功完成，控制台输出"任务执行完毕"。
如果任务被取消（即取消标记被触发），OperationCanceledException异常会被捕获，控制台输出"任务取消"。
这段代码展示了如何使用CancellationToken来取消异步任务，以及如何在任务被取消时处理相应的逻辑。通过在task.Wait(token)中传递取消标记，我们可以实现任务的取消操作，并在需要时做出相应的处理。

需要注意的是，在使用取消标记取消任务时，需要确保在合适的时机调用CancellationTokenSource的Cancel方法，以触发取消操作。否则，任务将继续执行，无法正常被取消。

Wait(TimeSpan timeout)：这个重载方法允许我们传递一个TimeSpan参数，指定等待的超时时间。如果在指定的超时时间内任务仍未完成，Wait()方法会返回并抛出一个System.Threading.Tasks.TaskTimeoutException异常。
static async Task Main()

static async Task Main()
{
    Task task = Task.Delay(5000); // 模拟一个耗时操作

    Console.WriteLine("任务开始执行");

    try
    {
        if (task.Wait(TimeSpan.FromSeconds(3))) // 等待任务完成，并设置超时时间为3秒
        {
            Console.WriteLine("任务执行完毕");
        }
        else
        {
            Console.WriteLine("任务超时");
        }
    }
    catch (TaskTimeoutException)
    {
        Console.WriteLine("任务超时");
    }
}

这段代码演示了如何使用Task.Wait方法设置任务的超时时间。

首先，我们创建了一个异步任务task，通过Task.Delay方法模拟一个耗时操作，持续5秒钟。
在控制台输出"任务开始执行"。
使用task.Wait(TimeSpan.FromSeconds(3))方法等待任务完成，并设置超时时间为3秒。该方法会阻塞当前线程，直到任务完成或超过指定的超时时间。
如果任务在指定的超时时间内完成，task.Wait方法返回true，控制台输出"任务执行完毕"。
如果任务在指定的超时时间内未能完成，task.Wait方法返回false，控制台输出"任务超时"。
如果在等待过程中抛出了TaskTimeoutException异常，则捕获该异常并输出"任务超时"。
通过在task.Wait方法中传递一个TimeSpan参数，我们可以设置任务的超时时间。如果任务无法在指定的时间内完成，可以根据需要进行相应的处理。

需要注意的是，在使用Task.Wait方法设置超时时间时，需要权衡超时时间的设定。如果超时时间太短，可能导致任务在尚未完成之前就被中止；如果超时时间太长，可能会对整体程序的性能产生负面影响。因此，在实际使用时，要根据具体情况合理设置超时时间。

通过使用这些重载形式的Task.Wait方法，可以灵活地控制任务的等待行为，包括取消等待和设置超时时间。这使得我们能够更好地管理异步任务的执行过程。

Task.Wait方法是用于等待异步任务完成的方法。它可以阻塞当前线程，直到任务完成或超时。在使用Task.Wait方法时，需要注意避免出现死锁或长时间的阻塞，以确保程序的性能和可靠性。

标签

#c#