WPF程序执行耗时任务时如何动态更新Label文本？

开发一款WPF桌面应用时遇到以下问题：用户扫描ID后程序会查询数据库并生成PDF，功能正常但耗时不稳定（2秒到30秒不等）。设置了lblPdfInfo标签用于提示操作状态，但标注>>>的两行状态更新代码不生效，程序要等PDF生成完成后才显示最终消息，用户容易误以为程序未响应。

当前按钮点击事件代码：

private void clkJobInfo(object sender, RoutedEventArgs e) {
    >>> lblPdfInfo.Text = $"Attempting to process {txtJobID}...";
    string sJobID = txtJobID.Text;
    int iJobID = 0;
    int.TryParse(sJobID, out iJobID);

    if (iJobID == 0) {
        lblPdfInfo.Text = "Job ID is not valid.  Please scan a valid job #";
    } else {
        >>> lblPdfInfo.Text = $"Generating PDF for {txtJobID}...";
        provider = new Provider(iJobID);
        if (provider.Success) {
            lblPdfInfo.Text = $"PDF for {provider.data.ProviderName} has printed. Scan new job when ready.";
            txtJobID.Text = String.Empty;
            txtJobID.Focus(FocusState.Programmatic);
        } else {
            lblPdfInfo.Text = $"Problem creating pdf - {provider.FailureMessage}";
        }
    }
    
}

问题根源是UI线程被阻塞：所有操作（包括耗时的数据库查询、PDF生成）都在UI线程同步执行，导致Label的更新请求被积压，直到所有耗时操作完成后才会一次性刷新。解决核心是用异步方式分离UI操作和耗时任务：

1. 修改按钮事件为异步方法
   将方法签名改为async void clkJobInfo，通过async/await让耗时操作在后台线程执行，不阻塞UI线程。

2. 将耗时操作移至后台线程
   用Task.Run把Provider实例化的耗时逻辑包装到后台线程，确保UI线程能及时更新Label内容。

3. 更新后的完整代码示例

private async void clkJobInfo(object sender, RoutedEventArgs e) {
    // 立即更新UI，提示开始处理
    lblPdfInfo.Text = $"Attempting to process {txtJobID.Text}...";
    
    string sJobID = txtJobID.Text;
    int iJobID = 0;
    if (!int.TryParse(sJobID, out iJobID)) {
        lblPdfInfo.Text = "Job ID is not valid.  Please scan a valid job #";
        return;
    }

    // 提示开始生成PDF
    lblPdfInfo.Text = $"Generating PDF for {txtJobID.Text}...";
    
    // 把耗时操作放到后台线程，不阻塞UI
    Provider provider = await Task.Run(() => new Provider(iJobID));

    if (provider.Success) {
        lblPdfInfo.Text = $"PDF for {provider.data.ProviderName} has printed. Scan new job when ready.";
        txtJobID.Text = string.Empty;
        txtJobID.Focus(FocusState.Programmatic);
    } else {
        lblPdfInfo.Text = $"Problem creating pdf - {provider.FailureMessage}";
    }
}

4. 额外注意事项
   • 所有UI控件的更新必须在UI线程执行：上述代码中await前后的UI操作都处于UI线程上下文，因此可以直接调用；如果后台线程中需要更新UI，需使用Dispatcher.Invoke切换回主线程。
   • 建议重构Provider类：避免在构造函数中执行耗时逻辑，改为提供异步初始化方法（如LoadAsync()），让代码结构更合理。

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