如何确保通过ControllerBase创建的WinForms窗体始终置顶？

问题描述 #

我有一个基于C#的WinForms应用程序，使用ControllerBase处理与Google Chrome扩展的交互。当收到结果时需要显示一个Form，但即使设置了TopMost = true并调用BringToFront()、Focus()等方法，窗体表现仍不稳定：有时能正常置顶显示，有时仅出现在任务栏，需用户点击才能前置聚焦。

补充说明：程序始终运行着一个MainForm，ControllerBase的逻辑就包含在其中，这个MainForm不一定处于可视或聚焦状态。

示例代码 #

[Route("api/example")]
[ApiController]
public class MinimalExampleController : ControllerBase
{
    [Route("sendcontent")]
    [HttpPost]
    public IActionResult OnResultReceived()
    {
        Form form = new Form();
        form.TopMost = true;
        form.BringToFront();
        form.Focus();
        
        form.ShowDialog();
        
        return Ok(); 
    }
}

解决方案 #

1. 强制在UI线程创建并显示窗体 #

ControllerBase的接口方法运行在ASP.NET后台线程，直接跨线程操作UI会导致窗体行为异常。需要切换到MainForm的UI线程执行：
首先在MainForm中保留静态实例引用：

public static MainForm Instance { get; private set; }

protected override void OnLoad(EventArgs e)
{
    base.OnLoad(e);
    Instance = this;
}

然后修改Controller中的代码：

[Route("api/example")]
[ApiController]
public class MinimalExampleController : ControllerBase
{
    [Route("sendcontent")]
    [HttpPost]
    public IActionResult OnResultReceived()
    {
        MainForm.Instance.Invoke(new Action(() =>
        {
            Form form = new Form();
            form.TopMost = true;
            // 指定MainForm为所有者，确保窗体层级正确
            form.ShowDialog(MainForm.Instance);
        }));

        return Ok(); 
    }
}

2. 正确设置窗体所有者与激活状态 #

使用ShowDialog(IWin32Window owner)指定所有者后，Windows会自动维护窗体的层级关系。同时可以在创建窗体时添加激活逻辑：

Form form = new Form();
form.TopMost = true;
form.WindowState = FormWindowState.Normal; // 确保窗体非最小化
form.Activate(); // 强制激活窗体
form.ShowDialog(MainForm.Instance);

3. 利用窗体事件强化置顶效果 #

如果仍有不稳定情况，可在窗体的Shown事件中再次强制置顶和激活：

Form form = new Form();
form.TopMost = true;
form.Shown += (sender, e) =>
{
    var currentForm = sender as Form;
    currentForm.TopMost = true;
    currentForm.Activate();
};
form.ShowDialog(MainForm.Instance);

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