输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
指南
指南应用框架ArkTS（方舟编程语言）ArkTS并发应用多线程开发实践应用多线程开发实践案例多线程取消TaskPool任务场景

多线程取消TaskPool任务场景

更新时间: 2026-09-09 06:54

由于任务池TaskPool的任务对象Task不支持跨线程传递，无法在子线程中直接取消任务。从API version 18开始，Task新增了任务ID属性，支持通过任务ID在子线程中取消任务。开发者可将已创建任务的任务ID存储在Sendable对象中，需要取消任务时，通过Sendable对象在子线程中取消任务。详情可参考以下示例。

  1. 定义一个Sendable类，在类属性中存储任务ID。

    收起
    自动换行
    深色代码主题
    复制
    1. // sendable.ets
    2. @Sendable
    3. export class SendableTest {
    4.   // 存储任务ID
    5.   private taskId: number = 0;
    6. 

    7.   constructor(id: number) {
    8.     this.taskId = id;
    9.   }
    10. 

    11.   public getTaskId(): number {
    12.     return this.taskId;
    13.   }
    14. }
    Sendable.ets

  2. 在UI主线程向TaskPool提交一个延时任务，并在子线程取消该任务。

    收起
    自动换行
    深色代码主题
    复制
    1. // TaskpoolCancel.ets
    2. import { taskpool } from '@kit.ArkTS';
    3. import { SendableTest } from '../utils/Sendable';
    4. import { BusinessError } from '@kit.BasicServicesKit';
    5. import { PromptAction } from '@kit.ArkUI';
    6. 

    7. @Concurrent
    8. function cancel(send: SendableTest) {
    9.   // 在子线程中通过任务ID取消任务
    10.   taskpool.cancel(send.getTaskId());
    11.   console.info('cancel task finished');
    12. }
    13. 

    14. @Concurrent
    15. function delayed() {
    16.   console.info('delayed task finished');
    17. }
    18. 

    19. @Entry
    20. @Component
    21. struct TaskpoolCancel {
    22.   @State message: string = 'CancelTaskpool';
    23.   @State returnMessage: string = 'return...';
    24.   @State promptAction: PromptAction = this.getUIContext().getPromptAction();
    25. 

    26.   build() {
    27.     Row() {
    28.       Column() {
    29.         Button(this.message)
    30.           .fontSize(25)
    31.           .fontWeight(FontWeight.Bold)
    32.           .onClick(async () => {
    33.             let task = new taskpool.Task(delayed);
    34.             taskpool.executeDelayed(2000, task).catch((e: BusinessError) => {
    35.               console.error(`taskpool execute error, message is: ${e.message}`);
    36.               // taskpool execute error, message is: taskpool:: task has been canceled.
    37.             });
    38.             let send = new SendableTest(task.taskId);
    39.             taskpool.execute(cancel, send).then(() => {
    40.               this.returnMessage = 'Taskpool canceled!';
    41.               this.promptAction.showToast({ message: this.returnMessage });
    42.             });
    43.           })
    44.         // ...
    45.       }
    46.       .width('100%')
    47.     }
    48.     .height('100%')
    49.   }
    50. }
    TaskpoolCancel.ets
获取最近访问列表场景
自定义Native Transferable对象的多线程操作场景
相关推荐
文档主动取消TaskPool任务的实现
文档TaskPool简介
文档@ohos.taskpool (启动任务池)
文档TaskPool多线程如何共享对象
文档批量数据写数据库场景
文档使用TaskPool执行多个耗时任务
文档TaskPool任务与宿主线程通信
文档长时任务并发场景简介
文档TaskPool在任务执行过程中如何跟主线程进行通信？如何操作同一块内存变量
示例代码基于TaskPool实现多线程任务
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词