Blazor 中取消长时间运行的任务,核心是使用
CancellationToken配合
async/await,并在组件销毁或用户主动触发时通知任务停止。
在组件中正确注入和使用 CancellationToken
Blazor 组件(尤其是 Server-Side 或 WebAssembly)本身不自动提供取消令牌,但
ComponentBase提供了
CancellationTokenSource的生命周期钩子支持。推荐在
OnInitializedAsync或
OnParametersSetAsync中创建,并在
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设计,取消逻辑就清晰可控。
