WPF应用使用Dispatcher类遇UI更新失效及窗口冻结问题求助

我正尝试为数据加载添加ProgressBar，希望在AdminWindow显示前（无数据时显示该窗口）展示剩余待加载的数据量，目前遇到两个问题：

1. 无法看到更新的文本 #

尝试过用Dispatcher类解决：

public void UpdateProgress(int processedEmails, int totalEmails)
{
    // 在拥有UI的线程上更新文本和进度条
    Dispatcher.Invoke(() =>
    {
        // 更新文本
        txtProgress.Text = $"Remains to load {totalEmails - processedEmails} from {totalEmails} newly saved";

        // 计算并更新进度（示例为百分比进度）
        double progressPercentage = (double)processedEmails / totalEmails * 100;
        progressBar.Value = progressPercentage;

        // 数据加载完成后显示AdminWindow并隐藏ProgressWindow
        if (processedEmails == totalEmails)
        {
            admin.Show();
            Hide();
        }
    });
}

也尝试过async和Task：

public async Task UpdateProgressAsync(int processedEmails, int totalEmails)
{
    await Dispatcher.InvokeAsync(() =>
    {
        // 同上逻辑
    });
}

数据处理的实现代码：

private async Task ProcessEmails()
{
    using (var client = new ImapClient())
    {
        int processedEmailsCount = 0; // 已处理邮件数
        int totalEmailsCount = uids.Count; // 待处理邮件总数

        foreach (var uid in uids)
        {
            foreach (var item in FindResult(GetBodyText, message))
            {
                Save(item);
                processedEmailsCount++; 
            }

            inbox.AddFlags(uid, MessageFlags.Seen, true);

            // 更新ProgressWindow状态
            await progress.UpdateProgressAsync(processedEmailsCount, totalEmailsCount);

            if (totalEmailsCount == 0)
            {
                OnAdminWindowReady();
            }
        }

        client.Disconnect(true);
    }
}

// 从数据库加载已保存数据的事件
protected virtual void OnAdminWindowReady()
{
    AdminWindowReady?.Invoke(this, EventArgs.Empty);
}

2. 两个窗口均冻结 #

使用Dispatcher时，数据加载后仅显示空白冻结窗口；使用async和Task时，窗口显示正常但仍处于冻结状态。

问题根源分析 #

1. 文本不更新：主线程被耗时的同步操作（如Save、IMAP邮件处理）阻塞，导致UI更新请求被积压，无法及时渲染。
2. 窗口冻结：ProcessEmails标记了async但内部没有真正的异步执行逻辑，所有耗时操作都在UI线程同步运行，直接卡死UI。

解决方案 #

核心思路：将耗时操作移到后台线程，用IProgress<T>优雅更新UI

1. 定义进度数据类，统一传递进度信息：

public class EmailProgress
{
    public int ProcessedCount { get; set; }
    public int TotalCount { get; set; }
}

2. 重构ProcessEmails方法，真正异步执行耗时操作：

private async Task ProcessEmails()
{
    // 创建进度报告器，自动切换到UI线程处理更新
    var progressReporter = new Progress<EmailProgress>(progress =>
    {
        txtProgress.Text = $"剩余待加载：{progress.TotalCount - progress.ProcessedCount} / 总计{progress.TotalCount}条新数据";
        progressBar.Value = (double)progress.ProcessedCount / progress.TotalCount * 100;

        if (progress.ProcessedCount == progress.TotalCount)
        {
            admin.Show();
            Hide();
        }
    });

    // 把所有耗时操作放到后台线程，避免阻塞UI
    await Task.Run(async () =>
    {
        using (var client = new ImapClient())
        {
            // 使用IMAP客户端的异步方法（如果有），没有则保持同步但在后台线程执行
            // await client.ConnectAsync("imap.example.com", 993, true);
            // await client.AuthenticateAsync("username", "password");
            
            var inbox = client.Inbox;
            inbox.Open(FolderAccess.ReadWrite);

            int processed = 0;
            int total = uids.Count;

            foreach (var uid in uids)
            {
                // 获取邮件
                var message = inbox.GetMessage(uid);
                foreach (var item in FindResult(GetBodyText, message))
                {
                    // 同步Save方法放到后台线程，或改成异步SaveAsync并await
                    await Task.Run(() => Save(item));
                    processed++;
                }

                // 标记邮件已读
                inbox.AddFlags(uid, MessageFlags.Seen, true);

                // 报告进度，自动切UI线程
                ((IProgress<EmailProgress>)progressReporter).Report(new EmailProgress
                {
                    ProcessedCount = processed,
                    TotalCount = total
                });
            }

            // 断开连接
            client.Disconnect(true);
        }
    });

    if (totalEmailsCount == 0)
    {
        OnAdminWindowReady();
    }
}

3. 移除原有的UpdateProgress/UpdateProgressAsync方法，用IProgress<T>替代。

关键优化点 #

• 后台线程执行耗时操作：用Task.Run把IMAP处理、数据保存等耗时逻辑移到后台，释放UI线程。
• IProgress自动管理UI线程：无需手动调用Dispatcher，框架自动处理线程切换，代码更简洁可靠。
• 优先使用异步API：如果IMAP客户端、数据保存方法有异步版本，优先使用并await，最大化异步效率。

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