首页 > 代码库 > 异步的返回类型

异步的返回类型

异步的返回类型

  异步方法具有三个可能的返回类型:Task<TResult>、Task和 void。 

 

Task(TResult) 返回类型

    Task<TResult> 返回类型可用于某种异步方法,其中操作数含有类型 TResult

  在下面的示例中,GetDateTimeAsync 异步方法包含返回整数的 return 语句。 因此,方法声明必须指定 Task<int>

        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 返回的任务中的 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 访问此值,而不是直接访问属性。

 

Task 返回类型

  不包含 return 语句或包含不返回操作数的 return 语句的异步方法通常具有返回类型 Task。 如果被编写为异步运行,这些方法将为返回 void 的方法。 如果在异步方法中使用 Task 返回类型,调用方法可以使用 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 返回类型。 void 返回类型还可用于替代返回 void 的方法,或者用于执行可分类为"调用后不管了"活动的方法。 但是,你应尽可能地返回 Task,因为不能 await 返回 void 的异步方法。 这种方法的任何调用方只能够继续完成,而无需等待调用的异步方法完成,并且调用方必须独立于异步方法生成的任何值或异常。

  返回 void 的异步方法的调用方无法捕获从该方法引发的异常,且此类未经处理的异常可能会导致应用程序故障。 如果返回 Task 或 Task<TResult> 的异步方法中出现异常,此异常将存储于返回的任务中,并在等待该任务时再次引发。 因此,请确保可以产生异常的任何异步方法都具有返回类型 Task 或 Task<TResult>,并确保会等待对这些方法的调用。

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

 

  void 返回值示例:

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

 

异步编程的系列

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

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

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

 

 


 

【博主】反骨仔

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

【参考】微软官方文档

异步的返回类型