0

0

c# Task.FromException 和 Task.FromCanceled 的作用

星降

星降

发布时间:2026-01-23 11:03:08

|

499人浏览过

|

来源于php中文网

原创

Task.FromException 创建已失败的 Faulted 状态 Task,用于同步校验失败;Task.FromCanceled 创建已取消的 Canceled 状态 Task,仅接受已取消的 CancellationToken,二者均轻量、不触发调度器。

c# task.fromexception 和 task.fromcanceled 的作用

Task.FromException 用来快速创建已失败的 Task

当你需要返回一个已经抛出异常的 Task(比如在异步方法早期校验失败时),不用真正启动异步操作,直接用 Task.FromException 构造即可。它等价于手动创建 Task 后调用 TrySetException,但更简洁安全。

常见错误是误以为它会“抛出”异常——其实它只是让返回的 Task 处于 Faulted 状态,调用方仍需 await.Wait() 才会真正观察到异常。

  • 参数必须是非空的 Exception 实例;传 null 会抛 ArgumentNullException
  • 适用于同步失败场景,比如参数校验不通过、配置缺失等
  • 生成的 TaskStatusTaskStatus.FaultedException 属性包含原始异常
public Task GetDataAsync(string id)
{
    if (string.IsNullOrEmpty(id))
        return Task.FromException(new ArgumentException("id cannot be null or empty"));
    
    return RealGetDataAsync(id);
}

Task.FromCanceled 用来快速创建已取消的 Task

当异步逻辑在进入实际工作前就响应了 CancellationToken 的取消信号,用 Task.FromCanceled 可以避免不必要的资源分配或状态机开销。它生成的 Task 状态为 Canceled,且内部封装的是 OperationCanceledException(即使你传入的是普通 CancellationToken)。

注意:如果传入的 CancellationToken 没有被取消(IsCancellationRequested == false),该方法会抛出 ArgumentException —— 它只接受**已取消**的 token。

  • 返回的 TaskStatusTaskStatus.Canceled
  • Exception.InnerException 会是原始的 OperationCanceledException,其 CancellationToken 字段与传入一致
  • 不要用它来“模拟取消”,而应真实检查 token.IsCancellationRequested 后再调用
public Task ProcessAsync(CancellationToken token)
{
    if (token.IsCancellationRequested)
        return Task.FromCanceled(token);
    
    return LongRunningWorkAsync(token);
}

两者都不触发调度器,也不涉及线程/状态机

Task.FromExceptionTask.FromCanceled 都是轻量级工厂方法,底层直接使用 TaskCompletionSource 构建已完成状态的 Task,不经过 ThreadPool、不触发 SynchronizationContext、也不生成 async 状态机。性能开销极小,适合高频路径(如 API 参数拦截、短路逻辑)。

趣问问AI
趣问问AI

免费可用的国内版chat,AI写作和AI对话

下载

容易踩的坑是混淆它们和 throw new OperationCanceledException() 的行为:后者在同步上下文中立即中断执行流;而这两个方法只是返回一个“结果已知”的 Task,调用方仍要 await 才会传播异常或取消状态。

  • 它们返回的 Task 是 cold 的(已完成),不会重复执行
  • 不能用于替代 Task.Run(() => { throw ... }) 这类带执行逻辑的写法
  • 在泛型重载中,类型参数必须严格匹配返回值类型,否则编译失败

别把 FromCanceled 当作取消通知的唯一手段

真正健壮的取消处理,必须在长期运行的操作中持续轮询 CancellationToken 或注册回调(Register),而不能只依赖入口处一次 FromCanceled。很多开发者以为加了这句就“支持取消”了,结果实际工作仍在后台跑着。

另外,Task.FromCanceled 创建的 Task 虽然状态是 Canceled,但如果调用方用 await 后没做 try/catch,程序仍会因未处理的 OperationCanceledException 终止(尤其在 .NET 6+ 默认启用取消异常传播的情况下)。

最常被忽略的一点:Task.FromCanceled(token) 中的 token 必须是已取消的;但很多人直接传入方法参数的 cancellationToken,却忘了先判断 IsCancellationRequested —— 这会导致运行时异常,而不是预期的取消响应。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

233

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

437

2024.03.01

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

6106

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

812

2023.09.14

token怎么获取
token怎么获取

获取token值的方法:1、小程序调用“wx.login()”获取 临时登录凭证code,并回传到开发者服务器;2、开发者服务器以code换取,用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容,可以阅读本专题下面的文章。

1064

2023.12.21

token什么意思
token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易,用来购买或出售特定的虚拟货币,也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

1278

2024.03.01

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

482

2023.08.10

Golang 性能分析与pprof调优实战
Golang 性能分析与pprof调优实战

本专题系统讲解 Golang 应用的性能分析与调优方法,重点覆盖 pprof 的使用方式,包括 CPU、内存、阻塞与 goroutine 分析,火焰图解读,常见性能瓶颈定位思路,以及在真实项目中进行针对性优化的实践技巧。通过案例讲解,帮助开发者掌握 用数据驱动的方式持续提升 Go 程序性能与稳定性。

9

2026.01.22

html编辑相关教程合集
html编辑相关教程合集

本专题整合了html编辑相关教程合集,阅读专题下面的文章了解更多详细内容。

53

2026.01.21

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
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号