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<string> GetDataAsync(string id)
{
    if (string.IsNullOrEmpty(id))
        return Task.FromException<string>(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 —— 这会导致运行时异常,而不是预期的取消响应。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

通义千问
通义千问

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

254

2023.09.22

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

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

1089

2024.03.01

登录token无效
登录token无效

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

6606

2023.09.14

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

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

842

2023.09.14

token怎么获取
token怎么获取

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

1092

2023.12.21

token什么意思
token什么意思

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

2108

2024.03.01

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

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

765

2023.08.10

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

9

2026.03.11

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

22

2026.03.10

热门下载

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

精品课程

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