Blazor 怎么取消一个长时间运行的任务

Blazor中取消长时间运行任务需使用CancellationToken配合async/await,在OnInitializedAsync中创建CancellationTokenSource,DisposeAsync中取消并释放,支持手动取消按钮和HTTP/Task.Delay等原生可取消操作。

Blazor 中取消长时间运行的任务,核心是使用 CancellationToken 配合 async/await,并在组件销毁或用户主动触发时通知任务停止。

在组件中正确注入和使用 CancellationToken

Blazor 组件(尤其是 Server-Side 或 WebAssembly)本身不自动提供取消令牌,但 ComponentBase 提供了 CancellationTokenSource 的生命周期钩子支持。推荐在 OnInitializedAsyncOnParametersSetAsync 中创建,并在 DisposeAsync 中取消:

  • 声明私有字段:private CancellationTokenSource? _cts;
  • 初始化时创建:_cts = new CancellationTokenSource();
  • 调用异步方法时传入 _cts.Token
  • DisposeAsync 中调用 _cts?.Cancel(); _cts?.Dispose();

手动触发取消(比如点击“取消”按钮)

用户可能中途想中止操作。只需暴露一个方法绑定到按钮,调用 Cancel() 即可:

  • 定义方法:private void OnCancel() => _cts?.Cancel();
  • 在 UI 中添加按钮:
  • 被调用的异步方法需定期检查令牌,例如:token.ThrowIfCancellationRequested(); 或用 if (token.IsCancellationRequested) return;

注意后台任务的可取消性

不是所有操作都天然支持取消。关键点:

  • HttpClient.GetAsync(url, token)Task.Delay(ms, token) 等原生支持令牌
  • 自定义循环或 CPU 密集型操作,必须手动插入 token.ThrowIfCancellationRequested();
  • 避免在 try/catch 中吞掉 OperationCanceledException,除非你明确要静默处理取消

Server-Side Blazor 的额外考虑

服务端组件可能因连接断开或页面跳转而失效,此时框架会调用 DisposeAsync —— 所以确保你的 CancellationTokenSource 在这里被正确取消,防止任务继续占用服务器资源。

基本上就这些。只要从开始就带着 CancellationToken 设计,取消逻辑就清晰可控。