0

0

C#的CancellationToken是什么?如何实现可取消的异步操作?

幻夢星雲

幻夢星雲

发布时间:2025-11-16 15:46:33

|

703人浏览过

|

来源于php中文网

原创

CancellationToken通过协作方式取消异步操作,由CancellationTokenSource创建并调用Cancel()触发取消,需在代码中主动检查token.IsCancellationRequested或传递token给支持的API,最终抛出OperationCanceledException以响应取消。

c#的cancellationtoken是什么?如何实现可取消的异步操作?

CancellationToken 是 C# 中用于协作式取消异步或长时间运行操作的机制。它本身不强制终止任务,而是提供一种通知方式,让被调用方可以监听取消请求,并在合适时机优雅地退出操作。

理解 CancellationToken

CancellationToken 通常由 CancellationTokenSource 创建。调用 CancellationTokenSource 的 Cancel() 方法后,所有关联的 token 会进入“已取消”状态,并触发注册的回调函数(如果有的话)。

关键点是:取消是协作式的——你必须在代码中定期检查 token 是否被取消,并自行处理清理逻辑。

如何实现可取消的异步操作

以下是在异步方法中使用 CancellationToken 的常见模式:

1. 在方法签名中接收 CancellationToken 参数

约定俗成地将 CancellationToken 设为最后一个可选参数:

public async Task DoWorkAsync(CancellationToken token = default)

2. 在 await 调用中传递 token

很多异步 API(如 HttpClient、StreamReader 等)都支持接收 CancellationToken:

例如:

var client = new HttpClient();

var content = await client.GetStringAsync("https://example.com", token);

3. 手动检查取消状态

在循环或长时间计算中,主动轮询 token.IsCancellationRequested:

for (int i = 0; i

{

  token.ThrowIfCancellationRequested(); // 如果已取消,抛出 OperationCanceledException

  // 或者手动判断

  if (token.IsCancellationRequested)

  {

    return; // 或抛出异常

  }

  await Task.Delay(100, token); // 带 token 的等待

}

4. 使用 CancellationToken.Register 注册取消回调

可在 token 上注册一个动作,当取消发生时自动执行,比如释放资源:

using var registration = token.Register(() => Console.WriteLine("取消了!"));

完整示例

static async Task Main(string[] args)

Android配合WebService访问远程数据库 中文WORD版
Android配合WebService访问远程数据库 中文WORD版

采用HttpClient向服务器端action请求数据,当然调用服务器端方法获取数据并不止这一种。WebService也可以为我们提供所需数据,那么什么是webService呢?,它是一种基于SAOP协议的远程调用标准,通过webservice可以将不同操作系统平台,不同语言,不同技术整合到一起。 实现Android与服务器端数据交互,我们在PC机器java客户端中,需要一些库,比如XFire,Axis2,CXF等等来支持访问WebService,但是这些库并不适合我们资源有限的android手机客户端,

下载

{

  var cts = new CancellationTokenSource();

  _ = Task.Run(async () =>

  {

    await Task.Delay(2000);

    cts.Cancel(); // 2秒后触发取消

  });

  try

  {

    await LongRunningOperationAsync(cts.Token);

    Console.WriteLine("操作完成");

  }

  catch (OperationCanceledException)

  {

    Console.WriteLine("操作被取消");

  }

}

static async Task LongRunningOperationAsync(CancellationToken token)

{

  for (int i = 0; i

  {

    token.ThrowIfCancellationRequested();

    Console.WriteLine($"第 {i} 次工作...");

    await Task.Delay(500, token);

  }

}

基本上就这些。CancellationToken 让异步操作具备响应取消的能力,关键是调用方传 token,被调方监听并响应。配合 using 和 try-catch 可以做到资源安全和异常可控。

相关专题

更多
string转int
string转int

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

312

2023.08.02

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

713

2023.08.22

登录token无效
登录token无效

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

6048

2023.09.14

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

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

782

2023.09.14

token怎么获取
token怎么获取

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

1052

2023.12.21

token什么意思
token什么意思

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

1095

2024.03.01

string转int
string转int

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

312

2023.08.02

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

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

522

2024.08.29

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

74

2025.12.31

热门下载

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

精品课程

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

共94课时 | 5.8万人学习

C 教程
C 教程

共75课时 | 3.8万人学习

C++教程
C++教程

共115课时 | 10.7万人学习

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

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