WinUI 3项目中的窗口关闭事件处理最佳实践

问题背景

在WinUI 3应用程序开发中，开发者经常需要在主窗口关闭时执行一些清理操作或请求用户确认。然而，当从.NET 6升级到.NET 9时，一些原本正常工作的代码可能会出现问题，特别是在处理窗口关闭事件时尝试显示内容对话框的情况下。

问题现象

在.NET 9环境中，当开发者在Window.Closed事件处理程序中尝试显示ContentDialog时，会遇到无法捕获的Win32异常。这种异常即使在调试器中勾选了所有Win32异常选项也无法捕获，导致应用程序意外终止。

问题根源分析

经过深入分析，这个问题主要由两个关键因素导致：

1. 异步事件处理问题：开发者使用了async void作为事件处理程序的签名，这会导致事件处理程序不会等待异步操作完成就继续执行。在窗口关闭的上下文中，这意味着应用程序可能在对话框显示之前就已经开始关闭过程。

2. XAML根元素缺失：在WinUI 3中显示ContentDialog时，必须正确设置XamlRoot属性，否则对话框无法正确显示。这在.NET 9中可能变得更加严格。

解决方案

1. 同步事件处理模式

正确的做法是使用同步事件处理程序，并在其中设置一个标志位来控制窗口关闭行为：

private bool _isCloseRequested = false;

private void VmMainWindow_Closed(object sender, WindowEventArgs args)
{
    if (_isCloseRequested)
        return;
    
    args.Handled = true;
    _dispatcherQueue.TryEnqueue(async () => 
    {
        var answer = await ShowConfirmationDialog();
        if (answer == ContentDialogResult.Primary)
        {
            _isCloseRequested = true;
            App.MainWindow.Close();
        }
    });
}

2. 确保正确设置XamlRoot

在创建ContentDialog时，必须设置XamlRoot属性：

var dialog = new ContentDialog
{
    Title = "确认关闭",
    Content = "确定要关闭应用程序吗？",
    PrimaryButtonText = "确定",
    CloseButtonText = "取消",
    XamlRoot = App.MainWindow.Content.XamlRoot
};

最佳实践建议

1. 避免在事件处理程序中使用async void：这会导致无法正确等待异步操作完成，特别是在生命周期事件中。

2. 使用DispatcherQueue进行UI操作：当需要从非UI线程操作UI元素时，应该使用DispatcherQueue来确保操作在UI线程上执行。

3. 正确处理窗口关闭流程：窗口关闭是一个特殊的事件，应该设计为同步过程，任何需要用户确认的操作都应该在关闭请求发起前完成。

4. 考虑使用Closing事件替代Closed事件：在某些情况下，使用Window.Closing事件可能更为合适，因为它允许在窗口实际关闭前进行干预。

总结

在WinUI 3应用程序开发中，正确处理窗口关闭事件需要特别注意异步编程模式和UI线程的交互。通过采用同步事件处理模式、正确设置对话框属性以及合理设计关闭流程，可以避免在.NET 9升级过程中遇到的这类问题。这些最佳实践不仅解决了当前的问题，也为应用程序的稳定性和用户体验提供了更好的保障。