WinUI 3 Desktop应用无法接收资源管理器文件拖拽的问题排查

问题现象 #

在Windows 11上运行WinUI 3 Desktop应用时，从文件资源管理器的桌面、普通文件夹拖拽文件到应用窗口，Grid_DragOver()和DragEnter事件完全不触发，光标显示红色禁止符号。但从资源管理器「开始」区域的「最近」列表拖拽文件却能正常工作。已尝试清理缓存、重启应用和系统，问题仍存在。

相关代码 #

MainWindow.xaml #

<Grid AllowDrop="True" Drop="Grid_Drop" DragOver="Grid_DragOver" Background="LightGray">
    <TextBlock
        x:Name="FileNameTextBlock"
        Text="Drag a file here"
        HorizontalAlignment="Center"
        VerticalAlignment="Center"
        FontSize="20"
        FontWeight="Bold" />
</Grid>
</Window>

MainWindow.xaml.cs #

using Microsoft.UI.Xaml;
using Microsoft.UI.Xaml.Controls;
using Microsoft.UI.Xaml.Input;
using System;
using Windows.ApplicationModel.DataTransfer;
using Windows.Storage;

namespace FileDragDropApp
{
    public sealed partial class MainWindow : Window
    {
        public MainWindow()
        {
            this.InitializeComponent();
        }

        private async void Grid_Drop(object sender, DragEventArgs e)
        {
            if (e.DataView.Contains(StandardDataFormats.StorageItems))
            {
                var items = await e.DataView.GetStorageItemsAsync();
                if (items.Count > 0)
                {
                    var storageFile = items[0] as StorageFile;
                    if (storageFile != null)
                    {
                        FileNameTextBlock.Text = $"File: {storageFile.Name}";
                    }
                }
            }
        }

        private void Grid_DragOver(object sender, DragEventArgs e)
        {
            // 此方法未被触发
            e.AcceptedOperation = DataPackageOperation.Copy;
        }
    }
}

测试环境 #

• Windows 11 Pro 24H2（OS版本26100.2161）
• Microsoft.WindowsAppSDK 1.6.240923002
• Microsoft.Windows.SDK.BuildTools 10.0.26100.1742

修复方案 #

1. 添加文件系统访问权限 #

在Package.appxmanifest中添加broadFileSystemAccess权限，允许应用访问文件系统中的文件：

<!-- 在Package根节点添加命名空间 -->
<Package
    ...
    xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
    IgnorableNamespaces="uap mp rescap">

    ...

    <!-- 在Capabilities节点下添加权限 -->
    <Capabilities>
        <rescap:Capability Name="broadFileSystemAccess" />
    </Capabilities>
</Package>

2. 注册Win32窗口拖拽消息处理 #

WinUI 3 Desktop基于Win32框架，部分跨进程拖拽场景需要手动注册窗口的拖拽消息处理。在MainWindow构造函数中添加以下代码：

using WinRT.Interop;
using Windows.ApplicationModel.DataTransfer.DragDrop.Core;

public MainWindow()
{
    this.InitializeComponent();
    var hWnd = WindowNative.GetWindowHandle(this);
    CoreDragDropManager.GetForCurrentView().RegisterWithWindow(hWnd);
}

这段代码通过CoreDragDropManager将WinUI的拖拽系统与Win32窗口绑定，确保窗口能接收来自资源管理器的拖拽消息。

3. 统一运行权限 #

如果应用需要以管理员身份运行，必须同时启动管理员权限的文件资源管理器，否则系统会拦截跨权限的拖拽操作。建议优先以普通用户权限运行应用，避免权限冲突。

原因说明 #

「最近」列表的拖拽数据由系统进程托管，权限上下文与应用默认权限匹配，因此可以正常触发事件。而桌面、普通文件夹的拖拽由资源管理器进程发起，若应用未正确注册拖拽消息或缺少文件访问权限，系统会阻止事件传递，导致拖拽失败。

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