WinUI3调用ContentDialog.ShowAsync抛出ArgumentException异常如何解决

异常触发原因 #

WinUI3 中的 ContentDialog 与传统 UWP 实现逻辑不同，必须显式指定挂载的宿主窗口，否则系统无法确定对话框要渲染到哪个窗口上下文，调用 ShowAsync() 时就会抛出该参数范围异常。你当前的代码没有给实例化的 LoginDialog 指定 XamlRoot 属性，是直接触发报错的核心原因。
另外你当前代码中 OnLaunched 直接调用异步 void 类型的 Login() 方法，没有做等待处理，也可能导致后续出现未捕获的异步异常、窗口生命周期异常等问题。

解决方案 #

1. 给ContentDialog指定宿主窗口的XamlRoot #

修改 app.xaml.cs 中的登录逻辑，给实例化的 LoginDialog 赋值 XamlRoot 关联到主窗口，同时调整异步方法的返回类型避免 async void 带来的风险，修改后的代码如下：

protected override async void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
    m_window = new MainWindow();
    m_window.Activate();
    // 等待登录流程执行完成
    await LoginAsync();
}

// 调整异步方法返回值为Task，符合WinUI3异步开发规范
protected async Task LoginAsync()
{
    var messageDialog = new ContentDialogs.LoginDialog();
    // 关键：指定对话框的挂载根节点，关联到当前主窗口
    messageDialog.XamlRoot = m_window.Content.XamlRoot;
    // 如果主窗口未提前设置Content，也可以直接用 messageDialog.XamlRoot = m_window.XamlRoot;
    await messageDialog.ShowAsync();

    if (App.Aplicacao.Utilizador == null)
    {
        m_window.Close();
        return;
    }
}

2. 可选补充优化 #

你当前的 LoginDialog XAML 中没有配置任何按钮属性，如果后续需要默认的关闭/确认按钮，可以在ContentDialog标签中添加对应的属性配置：

<ContentDialog
    ... 其他原有属性
    CloseButtonText="取消"
    PrimaryButtonText="登录">
    <!-- 原有内容 -->
</ContentDialog>

如果是自定义登录按钮逻辑，在按钮点击事件中调用 this.Hide() 即可关闭对话框。

内容的提问来源于stack exchange，提问作者David Simões