[C#] async 的三大返回类型

async 的三大返回类型

  博主简单数了下自己发布过的异步文章,已经断断续续 8 篇了,这次我想以 async 的返回类型为例,单独谈谈。

  异步方法具有三个可让开发人员选择的返回类型:Task<TResult>、Task 和 void。 

  什么时候需要使用哪一种返回类型,具体情况需要具体分析。如果使用不当,程序的执行结果也许并不是你想要的,下面我们就来好好谈谈如何针对不同的情况选择不同的返回类型。

 

目录

  • 返回类型 - Task<TResult> 
  • 返回类型 - Task
  • 返回类型 - void
  • 小结

 

一、返回类型 - Task<TResult> 

  【记住】当你添加 async 关键字后,需要返回一个将用于后续操作的对象,请使用 Task<TResult>。

 

    Task<TResult> 返回类型可用于 async 方法,其中包含指定类型 TResult

  在下面的示例中,GetDateTimeAsync 异步方法包含一个返回当前时间的 return 语句。 因此,方法声明必须指定 Task<DateTime>

        async Task<DateTime> GetDateTimeAsync()
        {
            //Task.FromResult 是一个占位符,类型为 DateTime
            return await Task.FromResult(DateTime.Now);
        }

  

  调用 GetDateTimeAsync 方法:

        async Task CallAsync()
        {
            //在另一个异步方法的调用方式
            DateTime now = await GetDateTimeAsync();
        }

  当 GetDateTimeAsync 从 await 表达式中调用时,await 表达式将检索存储在由 GetDateTimeAsync 返回的 task 中的 DateTime 类型值。 

 

        async Task CallAsync()
        {
            //在另一个异步方法的调用方式
            //DateTime now = await GetDateTimeAsync();

            //换种方式调用
            Task<DateTime> t = GetDateTimeAsync();
            DateTime now = await t;
        }

  通过 CallAsync 方法对 GetDateTimeAsync 方法的调用,对非立即等待的方法 GetDateTimeAsync 的调用返回 Task<DateTime>。 该任务指派给示例中的 DateTime 的 Task 变量。 因为 DateTime 的 Task 变量是 Task<DateTime>,也就是说这里的 TResult 就是 DateTime 类型。 在这种情况下,TResult 表示日期类型。 当 await 应用于 Task<DateTime>,await 表达式的计算结果为 Task<DateTime> 的 DateTime 类型的内容。同时,该值会分配给 now 变量。

 

  这次我演示不同的变量,你可以自己对比下结果是否相同:

        async Task CallAsync()
        {
            //在另一个异步方法的调用方式
            DateTime now = await GetDateTimeAsync();

            //换种方式调用
            Task<DateTime> t = GetDateTimeAsync();
            DateTime now2 = await t;
        
       //输出的结果对比 Console.WriteLine($
"now: {now}"); Console.WriteLine($"now2: {now2}"); Console.WriteLine($"t.Result: {t.Result}"); }

  

  我这边可以给出的答案就是:结果是一样的。

  【注意】主要有两种方式获取结果值,一个是使用 Result 属性,一个是使用 await。他们的区别在于:如果你使用的是 Result,它带有阻塞性。即在任务完成之前进行访问读取它,当前处于活动状态的线程都会出现阻塞的情形,一直到结果值可用。所以,在绝大多数情况下,除非你有绝对的理由告诉自己,否则都应该使用 await,而不是属性 Result 来读取结果值。

 

二、返回类型 - Task

  【记住】你如果只是想知道执行的状态,而不需要一个具体的返回结果时,请使用 Task。

 

  一个返回类型为 Task 类型的异步方法,它的具体实现不应该包含 return 语句,或者说是一个 return void 的语句。这个 Task 类型是不包含属性 Result 的。跟 Task<TResult> 调用一样,调用方法直接使用 await 挂起并等待异步方法的执行完毕。

 

  请看示例:

        async Task DelayAsync()
        {
            //Task.Delay 是一个占位符,用于假设方法正处于工作状态。
            await Task.Delay(100);

            Console.WriteLine("OK!");
        }

  

  通过使用 await 语句而不是 await 表达式来调用和等待 DelayAsync 方法,类似于返回 void 的方法的调用语句。 await 运算符的应用程序在这种情况下不生成值。

  请看调用 DelayAsync 的示例。

            //调用和等待方法在同一声明中
            await DelayAsync();

 

  现在,我用将调用和等待的方法进行分离:

            //分离
            Task delayTask = DelayAsync();

            await delayTask;        

 

三、返回类型 - void

  【记住】如果在触发后,你懒得管,请使用 void。如事件处理程序(主要用途)。

 

  void 返回类型主要用在事件处理程序中,一种称为“fire and forget”(触发并忘记)的活动的方法。除了它之外,我们都应该尽可能是用 Task,作为我们异步方法的返回值。

  返回 void,意味着不能 await 该异步方法,即可能出现线程阻塞,并且也无法获取 exception,抛出的异常,通常这些异常会导致我们的程序失败,如果你使用的是 Task 和 Task<Result>,catch 到的异常会包装在属性里面,调用方法就可以从中获取异常信息,并选择正确的处理方式。

  现在,异常也可以使用 await 了,请移步到这里 《回眸 C# 的前世今生 - 见证 C# 6.0 的新语法特性》。

 

  void 返回值示例:

        private async void button1_Click(object sender, EventArgs e)
        {
            //启动进程并等待完成
            await Task.Delay(100);
        }

 

小结

  • 当你添加 async 关键字后,需要返回一个将用于后续操作的对象,请使用 Task<TResult>;

  • 你如果只是想知道执行的状态,而不需要知道具体的返回结果时,请使用 Task;

  • 如果在触发后,你懒得管,请使用 void。

  • 请尽量优先使用 Task<TResult> 和 Task 作为异步方法的返回类型。

 

异步编程的系列

  1. 利用 async & await 的异步编程

  2. 怎样使用 async & await 一步步将同步代码转换为异步编程

  3. 利用 async & await 进行异步 IO 操作

 

 


【博主】反骨仔

【出处】http://www.cnblogs.com/liqingwen/p/6218994.html 

【参考】https://docs.microsoft.com/en-us/dotnet/articles/csharp/programming-guide/concepts/async/async-return-types

【参考】微软官方文档

posted @ 2017-01-05 13:58  反骨仔  阅读(19426)  评论(23编辑  收藏  举报