0

0

c# 异步方法返回类型 Task, Task, void, ValueTask 的选择

幻夢星雲

幻夢星雲

发布时间:2026-01-07 11:41:02

|

239人浏览过

|

来源于php中文网

原创

必须用Task或Task时:需await、参与异步流或返回结果;async方法仅允许返回Task、Task、void、ValueTask、ValueTask,其中void仅限UI事件处理器。

c# 异步方法返回类型 task, task<t>, void, valuetask 的选择

什么时候必须用 TaskTask

当你需要被 await、参与异步控制流、或返回结果时,TaskTask 是唯一合规选择。C# 编译器只允许 async 方法返回这三种类型(加上 voidValueTask)——但 void 仅限事件处理器等极少数场景。

常见错误是误以为“不返回值就该用 void”,结果导致异常无法被调用方捕获、无法用 await 同步生命周期,甚至测试时难以等待完成。

  • Task:适合无返回值但需通知完成的异步操作,比如 SaveAsync()SendEmailAsync()
  • Task:有返回值且可能涉及 I/O 或线程切换,比如 GetUserAsync(int id) 返回 User
  • 所有 async 方法体中用了 await,却声明返回 void → 编译器不会报错,但会丢失上下文和异常传播能力

ValueTaskValueTask 的适用边界

ValueTask 不是万能替代品,它只为高频、短时、大概率同步完成的场景优化内存分配。比如缓存命中、内存内计算、或已预热的连接复用。

滥用 ValueTask 反而增加复杂度:它不可重复 await,不能直接传给 Task.WhenAll,也不能隐式转换Task(需显式调用 .AsTask())。

  • 适合:MemoryStream.ReadAsyncConcurrentDictionary.GetOrAdd 的异步重载、自定义缓冲读取器
  • 不适合:HttpClient.GetAsync、数据库查询、文件读写等绝大多数真正 I/O 场景 —— 这些几乎总是异步完成,ValueTask 带来的堆分配节省微乎其微,反而引入额外判断开销
  • 若方法既可能同步完成又可能异步完成,且被高频调用(如每毫秒调用数次),才值得考虑 ValueTask

async void 只在 UI 事件处理中勉强可用

async void 方法无法被 await,异常会直接抛到 SynchronizationContext(WinForms/WPF 中触发 Application.ThreadException,ASP.NET Core 中可能静默丢失),且无法参与取消传播。

Visual Studio IntelliCode
Visual Studio IntelliCode

微软VS平台的 AI 辅助开发工具

下载

它唯一被框架认可的使用位置是事件处理方法签名,例如 WinForms 的 button_Click 或 WPF 的 ButtonBase.Click

  • 禁止在业务逻辑层、服务类、工具类中暴露 async void 方法
  • 测试时无法 await 它,也无法用 CancellationToken 控制它
  • 若你写了 public async void DoWork() 并试图在单元测试里调用它 → 测试会立即结束,实际逻辑可能还没执行完

性能与可维护性的实际权衡点

选型不是看哪个“更先进”,而是看调用模式、生命周期和可观测性需求。95% 的业务代码用 TaskTask 最安全;ValueTask 是给基础库作者或性能敏感路径准备的“手术刀”,不是日常工具刀。

一个容易被忽略的事实:ValueTask 的结构体特性在跨 await 边界后可能引发装箱(尤其当它内部包装了 Task),此时比直接返回 Task 更重。

public ValueTask ReadAsStringAsync()
{
    if (_bufferedResult != null)
        return new ValueTask(_bufferedResult); // 同步路径:栈上分配
    else
        return new ValueTask(ReadFromNetworkAsync()); // 异步路径:内部仍持有一个 Task
}

如果这个方法常被 await 后再传给 Task.WhenAll,那每次都要走 .AsTask(),间接多一次分配 —— 此时不如一开始就返回 Task

相关专题

更多
golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

194

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

186

2025.07.04

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

314

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

529

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

49

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

193

2025.08.29

javascriptvoid(o)怎么解决
javascriptvoid(o)怎么解决

javascriptvoid(o)的解决办法:1、检查语法错误;2、确保正确的执行环境;3、检查其他代码的冲突;4、使用事件委托;5、使用其他绑定方式;6、检查外部资源等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

174

2023.11.23

java中void的含义
java中void的含义

本专题整合了Java中void的相关内容,阅读专题下面的文章了解更多详细内容。

94

2025.11.27

java学习网站推荐汇总
java学习网站推荐汇总

本专题整合了java学习网站相关内容,阅读专题下面的文章了解更多详细内容。

3

2026.01.08

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Django 教程
Django 教程

共28课时 | 2.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1万人学习

Sass 教程
Sass 教程

共14课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号