.NET 7下StartupNextInstance事件非主线程运行的UI交互问题

问题背景 #

将基于VB.NET、目标框架为.NET Framework的单实例Windows Forms应用迁移至.NET 7后，依赖MyApplication_StartupNextInstance事件创建新窗体等UI操作时出现异常：

• 事件处理程序运行在线程池工作线程而非主线程，导致新打开的窗体无响应；
• 使用WebBrowser等依赖STA线程的ActiveX控件时，抛出异常：ActiveX control '8856f961-340a-11d0-a96b-00c04fd705a2' cannot be instantiated because the current thread is not in a single-threaded apartment。

复现验证：在.NET Framework 4.7.2中该事件运行在主线程，可正常操作UI；.NET 7中事件默认在工作线程执行，违反WinForms UI操作必须在主线程的规则。

解决方法 #

WinForms要求所有UI元素的创建、操作必须在**主线程（UI线程）**中执行，因此需要将StartupNextInstance事件中的UI逻辑切换到主线程运行，核心是使用Invoke方法：

修改后的事件处理代码 #

Private Sub MyApplication_StartupNextInstance(sender As Object, e As StartupNextInstanceEventArgs) Handles Me.StartupNextInstance
    Try
        ' 获取已打开的主窗体（确保应用已初始化完成且存在UI线程上下文）
        Dim mainForm As Form = My.Application.OpenForms(0)
        ' 通过Invoke将UI操作切换到主线程执行
        mainForm.Invoke(Sub()
                            Dim frm2 As New Form1()
                            frm2.Show()
                        End Sub)
    Catch ex As Exception
        ' 异常提示也属于UI操作，同样需要切换到主线程
        If My.Application.OpenForms.Count > 0 Then
            My.Application.OpenForms(0).Invoke(Sub()
                                                  MsgBox("ERROR: " & ex.Message)
                                              End Sub)
        End If
    End Try
End Sub

补充说明 #

• 如果存在主窗体尚未初始化的极端情况，可以在应用启动时提前保存主线程的SynchronizationContext，后续通过该上下文切换线程：

  ' 在MyApplication_Startup事件中保存同步上下文
  Private Shared mainSyncContext As SynchronizationContext
  Private Sub MyApplication_Startup(sender As Object, e As StartupEventArgs) Handles Me.Startup
      mainSyncContext = SynchronizationContext.Current
  End Sub
  

  然后在StartupNextInstance中使用：

  mainSyncContext.Send(Sub()
                          Dim frm2 As New Form1()
                          frm2.Show()
                      End Sub, Nothing)
  

• 主线程默认是STA（单线程单元）模式，通过Invoke切换后，WebBrowser等依赖STA的控件可以正常初始化和运行。

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