C# & WPF加载窗口进度无法实时更新问题求助

问题概述 #

主窗口加载缓慢，添加带进度条的加载窗口后无法实时更新进度，所有进度更新均在主窗口加载完成后一次性执行。此前尝试BackgroundWorker引发循环依赖，改用Task.Run+Dispatcher.Invoke也未解决问题。

核心原因 #

1. 主窗口构造函数运行在UI线程，同步执行所有初始化操作会阻塞UI，导致进度条更新被延迟。
2. 业务类与UI组件直接耦合，引发循环依赖。
3. 错误嵌套Task.Run与Dispatcher.Invoke，反而加剧了UI线程阻塞。

可行解决方案 #

1. 重构初始化逻辑，异步执行耗时操作 #

将主窗口初始化逻辑从构造函数移至Loaded事件，配合async/await实现异步加载，避免阻塞UI线程。

2. 用IProgress<T>解耦业务与UI #

通过IProgress<T>接口传递进度，业务类只需调用Report方法汇报进度，无需引用任何UI组件，彻底解决循环依赖。

3. 简化UI更新逻辑 #

利用Progress<T>自动切换回UI上下文的特性，直接在进度回调中更新加载窗口，无需额外嵌套线程操作。

完整代码示例 #

ProgressBarWindow（加载窗口）

public partial class ProgressBarWindow : Window
{
    public ProgressBarWindow()
    {
        InitializeComponent();
    }

    // 对外暴露进度更新方法
    public void UpdateProgress(int percent)
    {
        LoadingBar.Value = percent;
        if (percent == 100) Close();
    }
}

MainWindow（主窗口）

DataHandler dataCtrl;
private ProgressBarWindow _loadingWindow;
private List<object> signatures = new List<object>();

public MainWindow(string version, string username, string password)
{
    InitializeComponent();
    // 加载完成后触发异步初始化
    Loaded += async (s, e) => await InitializeAsync(version, username, password);
}

private async Task InitializeAsync(string version, string username, string password)
{
    // 显示加载窗口
    _loadingWindow = new ProgressBarWindow();
    _loadingWindow.Show();

    // 创建进度报告器，回调自动在UI线程执行
    var progress = new Progress<int>(percent => _loadingWindow.UpdateProgress(percent));

    try
    {
        // 异步执行所有耗时操作
        await Task.Run(() =>
        {
            // 初始化业务类，传入进度报告器
            dataCtrl = new DataHandler(username, password, progress);
            progress.Report(10);

            signatures.Add(dataCtrl.user);
            progress.Report(40);

            // 获取业务数据（耗时操作）
            var defaultRepo = dataCtrl.getDefaultRepo("initialbinding mainwindow");
            var defaultJob = dataCtrl.getDefaultJob();
            progress.Report(70);

            // 回到UI线程执行UI绑定与设置
            Application.Current.Dispatcher.Invoke(() =>
            {
                MainWindowContainer.Title = $"SDS2 {DesignData.SDS2.Database.Version.ProgramVersion} Transmittal Report Tool";
                RepoBtn.Content = defaultRepo;
                JobBtn.Content = defaultJob;
                InputByCmbx.ItemsSource = signatures;
                InputCheckedByCmbx.ItemsSource = signatures;
                // ... 其他绑定逻辑
            });
            progress.Report(100);
        });
    }
    catch (Exception ex)
    {
        MessageBox.Show($"加载失败：{ex.Message}");
        _loadingWindow.Close();
    }
}

DataHandler（业务类）

public class DataHandler
{
    private readonly IProgress<int> _progress;
    public object user { get; private set; }

    public DataHandler(string username, string password, IProgress<int> progress)
    {
        _progress = progress;
        // 执行耗时初始化逻辑（如数据库连接、数据加载）
        // 示例：模拟耗时操作后汇报进度
        Thread.Sleep(500);
        user = new { Name = username };
        _progress.Report(5);
    }

    public string getDefaultRepo(string param)
    {
        // 模拟耗时操作
        Thread.Sleep(300);
        _progress.Report(20);
        return "默认仓库";
    }

    public string getDefaultJob()
    {
        // 模拟耗时操作
        Thread.Sleep(300);
        _progress.Report(30);
        return "默认任务";
    }
}

关键说明 #

• UI线程不阻塞：所有耗时操作放在Task.Run中执行，UI线程能及时响应进度条更新。
• 彻底解耦：业务类通过IProgress<T>汇报进度，无需引用任何UI组件，解决循环依赖。
• 正确的UI更新时机：UI绑定等操作必须回到UI线程执行，Progress<T>的回调自动在UI线程触发，无需额外Dispatcher.Invoke（除非在Task.Run内部直接操作UI）。

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