[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 作为异步方法的返回类型。
异步编程的系列
【博主】反骨仔
【出处】http://www.cnblogs.com/liqingwen/p/6218994.html
【参考】https://docs.microsoft.com/en-us/dotnet/articles/csharp/programming-guide/concepts/async/async-return-types
【参考】微软官方文档