在C#的异步编程场景中，我们经常需要实时向用户反馈长时间运行的操作进度，比如文件批量处理、数据批量上传等场景。IProgress接口就是.NET专门为这类需求设计的进度报告组件，它能在异步操作的执行线程和进度接收线程之间建立安全的通信通道，避免直接跨线程操作UI带来的异常。
IProgress接口基础介绍
IProgress<T>是一个泛型接口，定义了一个用于报告进度的方法，其定义如下：
public interface IProgress<T>
{
void Report(T value);
}
通常我们不会直接实现这个接口，而是使用.NET提供的实现类Progress<T>。Progress<T>会在构造函数中接收一个回调委托，当调用Report方法时，会在构造Progress<T>的线程上执行这个回调，这保证了进度更新操作可以安全地回到UI线程执行。
基础用法示例
下面以控制台程序为例，演示最简单的IProgress使用方式：
using System;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
// 创建Progress对象，指定进度类型为int，回调用于处理进度更新
var progress = new Progress<int>(percent =>
{
Console.WriteLine($"当前进度：{percent}%");
});
// 启动异步操作，传入进度报告对象
await ProcessDataAsync(progress);
}
static async Task ProcessDataAsync(IProgress<int> progress)
{
for (int i = 0; i <= 100; i += 10)
{
// 模拟耗时操作
await Task.Delay(200);
// 报告当前进度
progress.Report(i);
}
}
}
UI场景下的使用（WPF示例）
在WPF等UI框架中，使用IProgress可以直接安全地更新UI元素，不需要手动切换线程：
using System;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
namespace WpfProgressDemo
{
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
}
private async void StartButton_Click(object sender, RoutedEventArgs e)
{
// 在UI线程创建Progress对象，回调会在UI线程执行
var progress = new Progress<int>(percent =>
{
// 直接更新进度条和文本，不会跨线程异常
ProgressBar.Value = percent;
ProgressText.Text = $"{percent}%";
});
await DoWorkAsync(progress);
MessageBox.Show("操作完成");
}
private async Task DoWorkAsync(IProgress<int> progress)
{
for (int i = 0; i <= 100; i++)
{
await Task.Delay(50);
progress.Report(i);
}
}
}
}
对应的XAML布局代码：
<Window x:Class="WpfProgressDemo.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
Title="进度演示" Height="200" Width="300">
<StackPanel Margin="20">
<ProgressBar x:Name="ProgressBar" Height="20" Maximum="100"/>
<TextBlock x:Name="ProgressText" HorizontalAlignment="Center" Margin="0,10,0,0"/>
<Button x:Name="StartButton" Content="开始操作" Click="StartButton_Click" Margin="0,20,0,0"/>
</StackPanel>
</Window>
进阶使用技巧
自定义进度类型
IProgress的泛型参数可以是任意类型，我们可以定义包含更多信息的进度类：
public class ProcessProgress
{
// 进度百分比
public int Percent { get; set; }
// 当前处理的描述信息
public string Message { get; set; }
// 已处理的数据量
public long ProcessedCount { get; set; }
}
static async Task AdvancedProcessAsync(IProgress<ProcessProgress> progress)
{
long total = 1000;
for (int i = 0; i < total; i++)
{
await Task.Delay(10);
if (i % 100 == 0)
{
progress.Report(new ProcessProgress
{
Percent = (int)(i * 100.0 / total),
Message = $"正在处理第{i}条数据",
ProcessedCount = i
});
}
}
// 最后报告100%进度
progress.Report(new ProcessProgress
{
Percent = 100,
Message = "处理完成",
ProcessedCount = total
});
}
进度聚合处理
当有多个异步子操作需要同时报告进度时，可以封装一个进度聚合器：
public class ProgressAggregator<T> : IProgress<T>
{
private readonly Action<T> _handler;
private int _totalOperations;
private int _completedOperations;
public ProgressAggregator(Action<T> handler, int totalOperations)
{
_handler = handler;
_totalOperations = totalOperations;
}
public void Report(T value)
{
// 可以在这里统一处理所有子操作的进度，比如计算总进度
_handler?.Invoke(value);
}
public void OperationCompleted()
{
_completedOperations++;
// 报告总进度
Report((T)(object)(_completedOperations * 100 / _totalOperations));
}
}
注意事项
- Progress<T>的回调会在创建它的同步上下文执行，如果在没有同步上下文的线程（比如控制台程序的默认线程）创建，回调会在线程池线程执行。
- Report方法是异步执行的，不会阻塞调用它的线程，所以不要在Report之后立即假设进度已经更新。
- 不要在进度回调中执行耗时操作，否则会导致进度更新卡顿，甚至影响异步操作的执行效率。
- 如果异步操作可能被取消，需要结合CancellationToken使用，在进度报告中也可以检查取消状态。
常见问题解答
为什么进度更新不及时？
通常是因为Report调用过于频繁，或者进度回调中执行了耗时操作。可以适当降低进度报告的频率，比如每完成1%再报告一次，而不是每次循环都报告。
多个异步操作如何共享一个进度对象？
可以直接传入同一个IProgress实例，但是需要注意进度值的计算逻辑，避免多个操作报告的进度互相覆盖，建议使用前面提到的进度聚合器来处理这类场景。