C#类库实现等待用户输入且不冻结GUI的方案咨询

你遇到的两个问题本质是GUI线程的消息循环机制和同步等待逻辑的冲突：忙等while会占满GUI线程的CPU时间导致系统消息无法处理，裸开线程没有做同步等待逻辑自然会直接往下执行。推荐用TaskCompletionSource + GUI模态弹窗的方案即可满足需求，没有额外依赖，兼容性强。

实现逻辑（以WinForms为例，WPF逻辑完全一致） #

• 类库提前引用对应GUI框架的依赖：WinForms引用Microsoft.WindowsDesktop.App.WindowsForms，WPF引用Microsoft.WindowsDesktop.App.WPF
• 类内定义单次调用标记，以及TaskCompletionSource作为信号量承载用户选择结果
• 方法入口先做单次调用校验，避免重复执行产生异常
• 构造带两个按钮的弹窗窗体，给按钮绑定点击事件：点击后将对应结果写入TaskCompletionSource，再关闭窗体
• 补充窗体关闭兜底逻辑，处理用户直接点击右上角关闭按钮的场景
• 调用ShowDialog()以模态方式展示窗体，该方法会自动阻塞当前调用线程直到窗体关闭，不会冻结GUI消息循环

示例代码 #

using System.Drawing;
using System.Threading.Tasks;
using System.Windows.Forms;

public class TwoButtonSelector
{
    private bool _isInvoked = false;
    private TaskCompletionSource<int> _resultTcs;

    // 方法返回值：1=点击按钮1，2=点击按钮2，0=直接关闭窗口
    public int GetUserSelection()
    {
        if (_isInvoked)
            throw new InvalidOperationException("该方法仅可被调用一次");
        _isInvoked = true;

        // 非UI环境调用时初始化消息循环
        if (Application.OpenForms.Count == 0)
        {
            Application.SetHighDpiMode(HighDpiMode.SystemAware);
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
        }

        _resultTcs = new TaskCompletionSource<int>();

        // 构建GUI
        var dialog = new Form() { Size = new Size(320, 160), StartPosition = FormStartPosition.CenterScreen, Text = "请选择操作" };
        var button1 = new Button() { Text = "按钮1", Location = new Point(40, 60), Size = new Size(100, 35) };
        var button2 = new Button() { Text = "按钮2", Location = new Point(170, 60), Size = new Size(100, 35) };

        // 绑定按钮点击事件
        button1.Click += (sender, args) =>
        {
            _resultTcs.SetResult(1);
            dialog.Close();
        };
        button2.Click += (sender, args) =>
        {
            _resultTcs.SetResult(2);
            dialog.Close();
        };

        // 兜底关闭逻辑
        dialog.FormClosed += (sender, args) =>
        {
            if (!_resultTcs.Task.IsCompleted)
                _resultTcs.SetResult(0);
        };

        dialog.Controls.AddRange(new Control[] { button1, button2 });
        dialog.ShowDialog();
        dialog.Dispose();

        return _resultTcs.Task.Result;
    }
}

对应开发规范 #

• 所有GUI控件的创建、属性修改、事件绑定都必须在对应GUI框架的UI线程中执行，禁止在后台线程直接操作控件
• 禁止用空while循环、Thread.Sleep做业务等待，优先使用TaskCompletionSource、ManualResetEventSlim等原生同步结构，不会占用多余CPU也不会阻塞消息循环
• 方法执行完成后必须主动释放所有GUI控件资源，避免内存泄漏
• 单次调用校验放在方法入口第一行，异常提示清晰明确

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