如何在WinUI3应用中实现从文件资源管理器拖拽文件功能？

问题根源 #

拖拽文件到应用时出现禁止符号（“x”），且OnDragOver、OnDrop事件未按预期触发，核心原因有两点：

• MSIX打包的应用缺少文件访问权限，无法读取外部拖拽的文件
• 拖拽事件未标记为已处理，系统默认的禁止拖拽行为生效

修复方案 #

1. 配置应用文件访问权限 #

针对MSIX打包的应用，需在Package.appxmanifest中添加文件访问权限，否则应用无法获取拖拽的文件：

<Package ...>
  <Capabilities>
    <!-- 测试场景可使用全文件系统访问权限 -->
    <Capability Name="broadFileSystemAccess" />
    <!-- 生产环境建议针对特定库授权，例如：
    <uap:Capability Name="documentsLibrary" />
    <uap:Capability Name="picturesLibrary" />
    -->
  </Capabilities>
</Package>

注：使用broadFileSystemAccess时，需在系统设置中开启应用的文件系统权限（设置→隐私和安全性→文件系统）

2. 修正拖拽事件处理逻辑 #

在OnDragOver方法中添加e.Handled = true，强制使用自定义拖拽规则，同时优化拖拽提示：

private void OnDragOver(object sender, DragEventArgs e)
{
    e.AcceptedOperation = DataPackageOperation.Copy;
    // 标记事件已处理，覆盖系统默认禁止行为
    e.Handled = true;

    // 自定义拖拽UI，显示允许图标
    e.DragUIOverride.IsCaptionVisible = false;
    e.DragUIOverride.Glyph = DragUIOverrideGlyph.Accept;
}

3. 完善OnDrop事件的稳定性处理 #

添加异常捕获，避免文件读取失败导致应用崩溃：

private async void OnDrop(object sender, DragEventArgs e)
{
    e.Handled = true;
    if (!e.DataView.Contains(StandardDataFormats.StorageItems)) return;

    try
    {
        var items = await e.DataView.GetStorageItemsAsync();
        foreach (var item in items)
        {
            if (item is StorageFile file)
            {
                // 此处添加文件处理逻辑，例如获取文件路径
                var filePath = file.Path;
                // ...后续操作
            }
        }
    }
    catch (Exception ex)
    {
        var errorDialog = new ContentDialog
        {
            Title = "读取失败",
            Content = $"无法读取拖拽文件：{ex.Message}",
            CloseButtonText = "确定"
        };
        await errorDialog.ShowAsync();
    }
}

4. 确认XAML控件配置 #

原XAML中Grid的AllowDrop="True"及事件绑定已正确设置，无需修改：

<Grid Background="Teal" AllowDrop="True" DragOver="OnDragOver" Drop="OnDrop">
    <Border Background="Red" VerticalAlignment="Center" HorizontalAlignment="Center">
        <TextBlock Text="file drop here!" />
    </Border>
</Grid>

验证步骤 #

1. 重新生成并部署应用
2. 若使用全文件权限，前往系统设置开启应用的文件系统访问权限
3. 从资源管理器拖拽文件到应用区域，此时应显示允许拖拽的图标，且OnDragOver、OnDrop事件正常触发

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