MAUI中C#异步搜索任务的取消问题及实现诉求

问题背景 #

在MAUI应用中，用Community Toolkit的RelayCommand绑定SearchBar的TextChanged事件，实现对List<string>的前缀搜索。原本用CancellationTokenSource尝试取消旧异步任务，避免并发写入CollectionView绑定的SelectedTopicNames属性，但CancelAsync仅发送取消信号，不等待任务实际终止，若旧任务未执行到ThrowIfCancellationRequested就会继续执行赋值，引发UI更新混乱。

核心解决思路 #

要么让旧任务及时响应取消信号终止，要么在旧任务执行到UI更新步骤前强制检查取消状态，确保只有未被取消的任务才能更新SelectedTopicNames。

具体实现方案 #

1. 重构CancellationTokenSource管理逻辑 #

调整旧任务的取消等待逻辑，同时在任务的关键节点（尤其是UI赋值前）强制检查取消状态：

private CancellationTokenSource? _searchCts;
public IAsyncRelayCommand SearchCommand { get; }

public YourViewModel()
{
    SearchCommand = new AsyncRelayCommand<string>(ExecuteSearchAsync);
}

private async Task ExecuteSearchAsync(string searchText)
{
    // 先处理旧任务
    if (_searchCts != null)
    {
        _searchCts.Cancel();
        try
        {
            // 短暂等待旧任务处理取消信号
            await _searchCts.Token.WaitHandle.WaitOneAsync(TimeSpan.FromMilliseconds(100));
        }
        catch (OperationCanceledException)
        {
            // 忽略取消异常
        }
        _searchCts.Dispose();
    }

    // 创建新的取消令牌源
    _searchCts = new CancellationTokenSource();
    var token = _searchCts.Token;

    try
    {
        // 模拟异步搜索耗时（替换成实际的业务逻辑，比如API请求或本地计算）
        await Task.Delay(200, token);
        token.ThrowIfCancellationRequested(); // 第一步检查

        // 执行前缀搜索
        var result = YourStringList.Where(s => s.StartsWith(searchText, StringComparison.OrdinalIgnoreCase)).ToList();
        token.ThrowIfCancellationRequested(); // 赋值前再次检查

        // 只有未取消时才更新UI绑定属性
        SelectedTopicNames = result;
    }
    catch (OperationCanceledException)
    {
        // 任务被取消，跳过UI更新
    }
    finally
    {
        // 确保当前任务的令牌源被释放
        if (_searchCts?.Token == token)
        {
            _searchCts.Dispose();
            _searchCts = null;
        }
    }
}

2. 优化LINQ查询的取消响应 #

如果搜索是CPU密集型的遍历操作，把LINQ改成循环遍历，在每一步插入取消检查，确保及时响应信号：

var result = new List<string>();
foreach (var item in YourStringList)
{
    token.ThrowIfCancellationRequested();
    if (item.StartsWith(searchText, StringComparison.OrdinalIgnoreCase))
    {
        result.Add(item);
    }
}

3. 利用Community Toolkit内置的并发控制（可选） #

给AsyncRelayCommand设置禁止并发执行并自动取消旧任务，减少手动管理的复杂度：

SearchCommand = new AsyncRelayCommand<string>(ExecuteSearchAsync)
{
    AllowConcurrentExecution = false,
    CancelRunningTask = true
};

注意：即使开启这个配置，仍需在ExecuteSearchAsync中手动添加ThrowIfCancellationRequested检查，确保赋值前终止任务。

关键注意事项 #

• 赋值前必须检查取消状态：这是避免旧任务更新UI的最后一道防线，无论任务是否提前终止，都要在SelectedTopicNames = result前调用token.ThrowIfCancellationRequested()。
• 及时释放资源：在finally块中处理CancellationTokenSource的释放，避免内存泄漏。
• 不要依赖CancelAsync的等待：CancelAsync仅保证信号发送完成，必须在任务内部主动检查取消令牌。

内容的提问来源于stack exchange，提问作者supersonic-developer