WPF使用ParallelForEachAsync触发DependencySource同线程异常如何解决

问题核心原因 #

1. ParallelForEachAsync 会使用线程池线程执行传入的委托，你在委托内直接修改绑定到UI的依赖属性（BackColor、Icon）、操作UI绑定集合BindableCollection，WPF要求所有DependencyObject相关的更新必须在创建它的UI线程执行，因此抛出 Must create DependencySource on same Thread as the DependencyObject 异常。
2. 界面冻结是因为频繁的跨线程UI调度、以及IO操作（目录/文件枚举）和UI更新逻辑耦合，大量零散的UI通知事件占用UI线程资源导致卡顿。
3. 之前Freeze不生效是因为你定义的SolidColorBrush没有在创建后立即执行冻结，且直接引用的Application资源中的Brush默认未冻结，依然无法跨线程访问。

具体修复方案 #

1. 处理可冻结对象跨线程访问

将所有绑定用的Freezable类型（SolidColorBrush、Icon对应的ImageSource）创建后立即冻结，冻结后的对象支持跨线程读取：

public abstract class ABrowser:PropertyChangedBase
{
    // 从资源取颜色构造Brush，避免直接引用UI线程创建的未冻结Brush
    public readonly SolidColorBrush Primary = new SolidColorBrush((Color)Application.Current.Resources["PrimaryHueMidColor"]);
    public readonly SolidColorBrush Unselected = new SolidColorBrush(Colors.Red);
    public readonly SolidColorBrush Selected = new SolidColorBrush(Colors.ForestGreen);

    protected ABrowser()
    {
        // 构造函数中统一冻结所有Brush
        TryFreeze(Primary);
        TryFreeze(Unselected);
        TryFreeze(Selected);
    }

    private void TryFreeze(Freezable freezable)
    {
        if(freezable.CanFreeze) freezable.Freeze();
    }

    // 其余原有代码保持不变
}

如果Icon属性是ImageSource类型，构造Icon实例后也调用上述TryFreeze方法处理。

2. 拆分IO逻辑和UI更新逻辑

将耗时的IO操作（目录枚举、文件属性判断）放在线程池执行，所有UI相关的属性更新、集合操作都封送回UI线程执行，同时批量更新减少UI调度次数，解决界面卡顿：

public async void TreeViewItem_Expanded(TreeView sender, RoutedEventArgs e)
{
    try
    {
        var context = (e.OriginalSource as TreeViewItem).DataContext as ABrowser;
        // IO密集型操作不需要太高并行度，调低参数减少调度开销
        await context.Children.ParallelForEachAsync(ProcessMessageAsync, 2);
    }
    catch(Exception ex)
    {
        // 按需添加异常处理逻辑
    }
}

public async Task ProcessMessageAsync(ABrowser i)
{
    if (i.Children == null && i.IsNotFile && i.IsNotDrive)
    {
        // 纯IO逻辑在线程池执行，不碰任何UI绑定对象
        var tempItems = new List<FolderTreeItemViewModel>();
        bool hasTargetFiles = false;

        await Task.Run(() =>
        {
            // 枚举目录过滤隐藏项
            var folders = Directory.EnumerateDirectories(i.Name)
                .Where(f => (File.GetAttributes(f) & FileAttributes.Hidden) != FileAttributes.Hidden);
            foreach (var folder in folders)
            {
                tempItems.Add(new FolderTreeItemViewModel(this, i, folder));
            }

            // 枚举目标文件
            var files = Directory.EnumerateFiles(i.Name, "*OpenClassrooms.htm").ToList();
            hasTargetFiles = files.Any();
            foreach (var file in files)
            {
                tempItems.Add(new FolderTreeItemViewModel(this, i, file, true));
            }
        });

        // 所有UI更新统一封送回UI线程，批量更新减少通知次数
        await Application.Current.Dispatcher.InvokeAsync(() =>
        {
            i.Children = new BindableCollection<ABrowser>(tempItems);
            i.IsEnabled = hasTargetFiles;
        }, DispatcherPriority.Background);
    }
    else
    {
        await Application.Current.Dispatcher.InvokeAsync(() => i.IsEnabled = true, DispatcherPriority.Background);
    }
    await Console.Out.WriteLineAsync($"Processing Message: {i.Name}");
}

可选优化 #

如果层级较深、节点数量大，可以给BindableCollection开启批量更新模式，进一步减少集合变更通知的触发次数，降低UI线程负载。

内容的提问来源于stack exchange，提问作者Frenchy