如何实现SuperConsole类与Form同步运行且正常调用Form.Invoke？

核心思路 #

确保Form的窗口句柄完全创建后再对外暴露可调用接口，内部处理线程同步与句柄初始化逻辑，对类使用者完全透明。

具体实现步骤 #

1. 同步等待Form句柄创建完成 #

在启动UI线程后，通过ManualResetEvent等待Form的HandleCreated事件触发，确认句柄已创建后再让构造函数返回，避免调用方拿到实例时Form还未完成初始化：

public class SuperConsole
{
    private readonly Form _consoleForm;
    private readonly ManualResetEvent _handleCreatedSignal = new ManualResetEvent(false);

    public SuperConsole()
    {
        _consoleForm = new Form();
        // 句柄创建完成后发出信号
        _consoleForm.HandleCreated += (_, __) => _handleCreatedSignal.Set();

        // 启动UI线程并配置为STA模式（WinForms强制要求）
        var uiThread = new Thread(RunApplicationLoop)
        {
            IsBackground = true,
            ApartmentState = ApartmentState.STA
        };
        uiThread.Start();

        // 阻塞构造函数，直到句柄创建完成
        _handleCreatedSignal.WaitOne();
    }

    private void RunApplicationLoop()
    {
        Application.Run(_consoleForm);
    }

    // 封装Invoke逻辑，对外暴露安全的调用入口
    public void Invoke(Action action)
    {
        if (_consoleForm.IsDisposed)
            throw new ObjectDisposedException(nameof(_consoleForm));
            
        _consoleForm.Invoke(action);
    }

    // 示例：替代Console.WriteLine的方法
    public void WriteLine(string content)
    {
        Invoke(() =>
        {
            // 此处实现向Form输出文本的逻辑，比如追加到TextBox
            // 示例：_outputTextBox.Text += content + Environment.NewLine;
        });
    }
}

2. 强制UI线程为STA模式 #

WinForms控件必须运行在单线程单元（STA）线程中，启动UI线程时必须调用SetApartmentState(ApartmentState.STA)，否则会引发句柄创建异常或跨线程调用问题。

3. 封装所有控件操作 #

对外只暴露业务方法（如WriteLine），内部自动通过Invoke切换到UI线程执行，使用者无需关心线程与句柄细节。

4. 处理控件释放场景 #

在Invoke方法中检查Form是否已释放，避免调用已销毁控件的方法引发异常。

关键说明 #

• 用ManualResetEvent实现构造函数与UI线程的同步，保证调用方拿到实例时Form已完成句柄初始化，后续Invoke调用不会报错。
• 将UI线程设为后台线程，避免程序退出时因UI线程未终止而卡住。
• 所有控件操作都通过封装的Invoke执行，确保线程安全。

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