如何正确调用含循环的异步方法且不阻塞UI？解决相关异常

问题根源分析 #

1. 初始代码阻塞UI：BuildDocumentList标记为async Task但内部无任何异步等待逻辑，导致ProcessDocumentRange的循环全程同步执行在UI线程，直接阻塞界面更新。
2. STA线程异常：Document类错误继承MainWindow（UI控件类），而Task.Run启动的后台线程为MTA线程，无法创建WPF UI控件，因此抛出"The calling thread must be STA..."异常。
3. 线程安全隐患：List<Document>并非线程安全集合，后台线程直接操作可能引发线程冲突。

解决方案 #

1. 修复数据模型类 #

将Document改为普通数据类，移除对MainWindow的继承：

public class Document
{
    private int _year = -1;
    public int Year
    {
        get => _year;
        set => _year = value;
    }

    private int _image = -1;
    public int Image
    {
        get => _image;
        set => _image = value;
    }
}

2. 重构异步逻辑，确保非阻塞UI #

在后台线程完成所有文件检查和数据收集，再回到UI线程更新列表，避免线程安全问题：

public partial class MainWindow : Window
{
    private readonly List<Document> _queuedDocuments = new List<Document>();
    private string _instID = "";
    private static readonly string _dest = @"c:\test";
    private static readonly int _startId = 50001;
    private static readonly int _endId = 65001;

    public MainWindow()
    {
        InitializeComponent();
        _tbURL.Text = _url;
        _tbDest.Text = _dest;
        _tbStartId.Text = _startId.ToString();
        _tbEndID.Text = _endId.ToString();
    }

    private async void _btnStartClick(object sender, EventArgs e)
    {
        await ProcessDocumentRange(_startId, _dest);
    }

    private async Task ProcessDocumentRange(int startID, string root)
    {
        // 后台线程执行耗时的文件遍历与检查
        var missingDocuments = await Task.Run(() =>
        {
            var tempList = new List<Document>();
            int year = 28;
            for (int i = startID; i < _endId; i++)
            {
                _instID = $"{year}{i.ToString().PadLeft(5, '0')}";
                // 使用Path.Combine避免路径拼接错误
                string documentIndexFile = Path.Combine(root, year.ToString(), $"{_instID}.txt");
                
                if (!File.Exists(documentIndexFile))
                {
                    tempList.Add(new Document { Year = year, Image = i });
                }
            }
            return tempList;
        });

        // 回到UI线程更新列表，确保线程安全
        lock (_queuedDocuments)
        {
            _queuedDocuments.AddRange(missingDocuments);
        }

        // 若需绑定UI显示，可在此触发集合变更通知（如使用ObservableCollection）
    }
}

3. 额外优化建议 #

• 用Path.Combine拼接文件路径，避免手动拼接导致的格式错误。
• 若需实时显示进度，可使用Progress<T>类安全传递进度到UI线程。
• .NET Framework环境下无File.ExistsAsync时，用Task.Run包裹同步IO操作是合理的，不会阻塞UI。

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