0

0

c# Task.CompletedTask 的作用和用法

星降

星降

发布时间:2026-01-14 22:43:02

|

240人浏览过

|

来源于php中文网

原创

该用 task.completedtask 而不是 new task(() => {}) 时:需同步返回已完成 task 且无实际异步工作;前者零分配、已完成,后者需 start 且处于 created 状态致 await 卡死。

c# task.completedtask 的作用和用法

什么时候该用 Task.CompletedTask 而不是 new Task(() => {})

Task.CompletedTask 是一个预创建的、已成功完成的 Task 实例,适用于「同步返回已完成任务」的场景。它不分配新对象,也不启动线程或调度器,开销几乎为零。

直接 new Task(() => {}) 不仅要分配内存,还必须手动调用 .Start(),否则任务永远不执行;更严重的是,它处于 Created 状态,不是 Completed,下游 await 会卡住或抛 InvalidOperationException

  • ✅ 正确:返回已知无异步工作、但签名要求返回 Task 的方法
  • ❌ 错误:用它代替真正需要异步执行的逻辑(比如 I/O 或耗时计算)
  • ⚠️ 注意:Task.CompletedTask 没有结果值,返回 Task<t></t> 时得用 Task.FromResult<t>(value)</t>

Task.CompletedTaskTask.FromResult(0) 的区别

两者都代表已完成任务,但语义和类型完全不同:

  • Task.CompletedTaskTask 类型,适合 void-returning 异步方法签名
  • Task.FromResult(0) 返回 Task<int></int>,且 Result0;若你只需要完成信号,却用了它,就多装箱了一次(对值类型)或引入了不必要的数据
  • 性能上:CompletedTask 是静态只读字段,零分配;FromResult 每次调用都新建一个 Task<t></t> 实例(尽管内部做了缓存优化,但不如 CompletedTask 极致)
public async Task DoWorkAsync()
{
    // ✅ 同步路径,无实际异步操作
    if (_isDisabled)
        return Task.CompletedTask;
<pre class='brush:php;toolbar:false;'>await _service.ProcessAsync();

}

Mubert
Mubert

Mubert -一个使用人工智能算法和机器学习生成连续音乐流的平台

下载

在接口实现中强制使用 CompletedTask 的典型场景

当实现一个定义为 Task SomeMethodAsync() 的接口,但某个具体实现类根本不需要异步行为时,CompletedTask 是最轻量、最符合契约的选择。

  • 避免用 Task.Run(() => {}) —— 它会调度到线程池,引入不必要上下文切换
  • 避免用 Task.Delay(0) —— 创建定时器、触发调度,纯属浪费
  • 不能用 return; —— 编译失败,方法签名要求返回 Task
public class NullLogger : ILogger
{
    public Task LogAsync(string message)
    {
        // 什么也不做,但满足异步接口
        return Task.CompletedTask;
    }
}

容易忽略的陷阱:泛型任务和状态机生成

看起来只是“返回一个已完成任务”,但编译器对 async 方法的处理很敏感。如果在 async 方法里写 return Task.CompletedTask;,C# 仍会生成完整状态机 —— 即使没 await 任何东西。

真正零开销的做法是:不用 async 关键字,直接返回 Task.CompletedTask

  • public async Task M() => Task.CompletedTask; → 生成状态机,多余
  • public Task M() => Task.CompletedTask; → 直接返回,无状态机
  • ⚠️ 如果方法体里混有 await 和同步短路逻辑,才需要 async + 条件返回 CompletedTask

这个细节在高频调用路径(如中间件、序列化器)里会影响 GC 压力和内联机会。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

181

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

224

2025.12.18

string转int
string转int

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

890

2023.08.02

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

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

595

2024.08.29

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

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

294

2025.08.29

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

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

210

2025.08.29

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

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

185

2023.11.23

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

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

125

2025.11.27

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

24

2026.02.28

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
10分钟--Midjourney创作自己的漫画
10分钟--Midjourney创作自己的漫画

共1课时 | 0.1万人学习

Midjourney 关键词系列整合
Midjourney 关键词系列整合

共13课时 | 0.9万人学习

AI绘画教程
AI绘画教程

共2课时 | 0.2万人学习

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

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