基于.NET 4.8的WinForms异步加载时如何保持等待框动画流畅？

问题场景 #

在C# WinForms（.NET 4.8）应用中，需要在主视图显示前，弹出带有Marquee模式（块左右移动）进度条的等待框；等待框动画运行期间，异步执行服务连接与数据获取操作，完成后自动关闭等待框。当前实现代码杂乱，希望用更现代的方式替代BackgroundWorker或手动事件/信号量处理，核心要求是保持消息泵活跃，确保进度条动画流畅。

当前主逻辑实现代码：

try
{        
  WaitBoxForm.ShowWaitBox();

  var signal = new ManualResetEvent(false);               
  var task = Task.Run(async () =>
  {          
    apiAppKey = await GetLoginData();
    signal.Set();
  });
  while (!signal.WaitOne(TimeSpan.FromMilliseconds(1)))
  {
    Application.DoEvents();
  }       
}
catch (Exception ex)
{
  WaitBoxForm.CloseWaitBox();
  MessageService.Information(apiExceptionMessage(ex.Message));          
  return false;
}
finally
{
  WaitBoxForm.CloseWaitBox();
}

当前WaitBoxForm实现代码：

public partial class WaitBoxForm : Form
{
  private static WaitBoxForm waitBoxForm;
      
  public WaitBoxForm()
  {
    InitializeComponent();
  }

  public static void ShowWaitBox()
  {
    if (waitBoxForm != null) return;
         
    waitBoxForm = new WaitBoxForm();      
    Task.Run(() => Application.Run(waitBoxForm));
  }

  public static void CloseWaitBox()
  {
    if (waitBoxForm != null)
    {
      waitBoxForm.Invoke((Action)(() => waitBoxForm.Close()));
      waitBoxForm = null;
    }           
  }
}

优化方案 #

核心问题分析 #

原实现的弊端：

• 用ManualResetEvent+Application.DoEvents()模拟异步等待，DoEvents容易引发重入问题（比如用户意外操作其他控件）
• 通过Task.Run启动新的消息循环显示等待框，存在跨线程控件操作风险，且增加线程复杂度

优化后的实现 #

1. 重构WaitBoxForm

去掉静态单例模式，改为直接实例化使用，确保控件在UI线程创建：

public partial class WaitBoxForm : Form
{
    public WaitBoxForm()
    {
        InitializeComponent();
        // 显式设置进度条为Marquee模式（若设计时未设置）
        progressBar1.Style = ProgressBarStyle.Marquee;
        progressBar1.MarqueeAnimationSpeed = 30; // 调整动画速度，值越小越快
    }
}

2. 主逻辑用async/await实现异步等待

利用原生异步语法替代手动信号量，让UI线程在异步操作期间自然处理消息泵，保证动画流畅：

// 假设此方法为主窗体的异步Load事件，或启动逻辑入口
private async Task<bool> InitializeMainViewAsync()
{
    // 使用using块自动管理等待框的生命周期
    using (var waitBox = new WaitBoxForm())
    {
        waitBox.Show(); // 非阻塞显示等待框，UI线程继续处理消息
        
        try
        {
            // 异步执行数据获取，await会释放UI线程处理消息（包括进度条动画）
            apiAppKey = await GetLoginData().ConfigureAwait(true);
            // ConfigureAwait(true)确保执行完成后回到UI线程
            return true;
        }
        catch (Exception ex)
        {
            MessageService.Information(apiExceptionMessage(ex.Message));
            return false;
        }
        // 方法结束时，using块自动调用waitBox.Close()并释放资源
    }
}

关键说明 #

• 避免Application.DoEvents()：await会自动让UI线程在异步操作期间处理消息循环，无需手动调用DoEvents，从根源避免重入问题
• UI线程一致性：等待框在UI线程创建和显示，符合WinForms控件线程规则，无需跨线程调用Invoke关闭
• 生命周期管理：using块自动处理等待框的关闭与释放，比手动调用Close更可靠

若启动逻辑无法直接使用async（比如Program.Main），可将初始化逻辑移至主窗体的async void Load事件中，因为WinForms允许事件处理器为async void。

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