WinUI中替代MessageBox实现阻塞式ContentDialog的方案问询

核心思路 #

WinUI的ContentDialog.ShowAsync()是异步非阻塞设计，但要实现Win32 MessageBox的阻塞效果，不能直接阻塞主UI线程（会导致界面卡死）。核心方案是用ManualResetEvent等待用户操作完成，同时在等待间隙通过CoreDispatcher.ProcessEvents()持续处理UI消息队列，保证对话框能正常交互。

实现代码 #

创建静态工具类封装阻塞式对话框逻辑：

using System.Threading;
using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Controls;
using Windows.UI.Core;

public static class BlockingDialogHelper
{
    public static ContentDialogResult ShowBlockingDialog(Window parentWindow, string title, string content)
    {
        var dialogResult = ContentDialogResult.None;
        var waitEvent = new ManualResetEvent(false);

        // 初始化ContentDialog
        var dialog = new ContentDialog
        {
            Title = title,
            Content = content,
            PrimaryButtonText = "Yes",
            SecondaryButtonText = "No",
            XamlRoot = parentWindow.Content.XamlRoot // 必须设置XamlRoot，否则对话框无法显示
        };

        // 在主UI线程异步显示对话框，操作完成后触发等待事件
        _ = parentWindow.Dispatcher.TryRunAsync(CoreDispatcherPriority.Normal, async () =>
        {
            dialogResult = await dialog.ShowAsync();
            waitEvent.Set();
        });

        // 等待用户操作，期间持续处理UI消息避免界面卡死
        while (!waitEvent.WaitOne(10))
        {
            parentWindow.Dispatcher.ProcessEvents(CoreProcessEventsOption.ProcessAllIfPresent);
        }

        return dialogResult;
    }
}

使用示例 #

调用方式和Win32 MessageBox完全一致，无需改写原有代码的逻辑结构：

// 假设MainWindow是你的应用主窗口实例
var result = BlockingDialogHelper.ShowBlockingDialog(MainWindow, "确认操作", "是否执行此操作？");

if (result == ContentDialogResult.Primary)
{
    // 处理用户点击Yes的逻辑
}
else
{
    // 处理用户点击No或关闭对话框的逻辑
}

关键注意事项 #

• 必须设置XamlRoot：WinUI 3的ContentDialog依赖XamlRoot确定显示上下文，否则会抛出异常或无法正常显示。
• 消息循环处理：WaitOne(10)配合ProcessEvents确保等待期间主UI线程能处理所有待办UI事件，避免界面冻结。
• 线程安全：TryRunAsync确保对话框的创建和显示在主UI线程执行，符合WinUI的线程模型要求。

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