【C#】跨线程更新进度条_UpdateProgress 方法解析

文章目录UpdateProgress 方法解析逐段说明调用链UpdateProgress方法解析下边是实战项目中的一段代码比较有代表性对其进行解析privatevoidUpdateProgress(intcurrent,inttotal,stringmessage){// Cross-thread Safety if(this.InvokeRequired)//line:527{this.BeginInvoke(newAction(()UpdateProgress(current,total,message)));return;}// 设置进度条范围 progressBar.MaximumMath.Max(total,1);progressBar.ValueMath.Min(current,progressBar.Maximum);// 计算百分比 intpercenttotal0?current*100/total:0;// 更新文字标签 lblProgress.Textstring.IsNullOrEmpty(message)?${percent}%{current}/{total}:${message}{percent}%{current}/{total};}逐段说明行作用细节527-531UI 线程安全WinForms 控件只能在创建它们的线程UI 主线程上操作。刷写逻辑运行在后台线程Task.Run所以InvokeRequired检查是否跨线程。若是用BeginInvoke异步投递到 UI 线程重新执行避免死锁和跨线程异常532设置进度条上限Math.Max(total, 1)防止total为 0 时进度条报错ProgressBar 最大值不能为 0533设置当前进度Math.Min(current, total)防止current total越界534算百分比total 0防除零535-537设置文字有message如步骤名时前置显示否则仅显示百分比和计数调用链UpdateProgress通过事件订阅触发在SetupEvents()中注册Utils.Common.OnProgressUpdateProgress;刷写引擎内部通过Common.ShowProgress(current, total, message)触发实现解耦。帧率由Common内部节流控制避免 UI 线程被高频轰炸。