C# WinUI 3文件选择器 WinUI 3应用如何使用FileOpenPicker

来源：这里教程网时间：2026-02-21 17:42:26 作者：

WinUI 3里

FileOpenPicker

不能直接用

WinUI 3（尤其是打包为MSIX的应用）不支持传统UWP风格的

FileOpenPicker

同步调用方式，直接new

FileOpenPicker()

会编译失败或运行时报

System.Runtime.InteropServices.COMException: Error HRESULT E_FAIL

。根本原因是WinUI 3剥离了UWP应用模型中部分依赖

Windows.UI.Popups

和

Windows.Storage.Pickers

的旧API，改用基于

Windows.AppSDK

的新文件选择器——

Windows.System.Launcher.LaunchUriAsync

配合

Windows.Storage.Pickers.FileOpenPicker

的**异步委托模式**，但仅限于桌面桥接场景。

正确做法：用

Windows.Storage.Pickers.FileOpenPicker

PickerLocationId

配置

必须确保项目已引用

Microsoft.WindowsAppSDK

≥ 1.5，并在

Package.appxmanifest

中声明

rescap:Capability Name="broadFileSystemAccess"

（仅调试时需要，发布需合理申请权限）。实际代码中：

FileOpenPicker
实例必须通过
InitializeWithWindow
绑定主窗口句柄，否则弹窗无父窗口、可能被系统拦截必须设置
SuggestedStartLocation
（如
PickerLocationId.DocumentsLibrary
），否则某些系统版本会静默失败
FileTypeFilter
必须至少包含一个有效扩展名，例如
picker.FileTypeFilter.Add(".txt")
，空集合会导致
ArgumentException
调用
PickSingleFileAsync()
后，结果是
StorageFile
，不是
Stream
，需用
await file.OpenReadAsync()
打开

var picker = new Windows.Storage.Pickers.FileOpenPicker();
picker.InitializeWithWindow(hWnd); // hWnd来自MainWindow's WindowHandle
picker.SuggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.DocumentsLibrary;
picker.FileTypeFilter.Add(".json");
picker.FileTypeFilter.Add(".xml");
var file = await picker.PickSingleFileAsync();
if (file != null) {
    using var stream = await file.OpenReadAsync();
    // 处理流
}

常见报错和绕过方案

如果遇到

UnauthorizedAccessException

，说明未启用

broadFileSystemAccess

或用户拒绝了权限；若弹窗一闪而逝，大概率是

InitializeWithWindow

传入的

hWnd

无效（比如在后台线程调用、或

WindowHandle

尚未初始化完成）。

检查
hWnd
是否为
MainWindow
构造后获取：
App.MainWindow.WindowHandle
，而非在
OnLaunched
早期就取避免在
Loaded
事件外调用，确保UI线程就绪不要尝试用
DispatcherQueue
包装
PickSingleFileAsync
——它本身已是异步且需UI线程上下文若目标是打开任意路径（如C:\temp\*.log），
FileOpenPicker
受限于沙盒，应改用
Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:privacy-broadfilesystemaccess"))
引导用户手动授权

替代方案：用

Microsoft.WinUI.Controls.FileOpenPicker

（第三方封装）

社区有轻量封装库（如

CommunityToolkit.WinUI

）提供更友好的API，但底层仍调用原生

FileOpenPicker

。它的价值在于自动处理

hWnd

绑定和异常分类，比如：

var picker = new Microsoft.WinUI.Controls.FileOpenPicker();
picker.FileTypeFilter.Add(".png");
var result = await picker.PickSingleFileAsync();
// result.Stream 可直接读取，无需再OpenReadAsync

不过要注意：该封装不改变权限模型，