UWP应用中如何显示图片库内非项目Assets的JPG图片？

嘿，我太懂你这个困扰了——UWP的文件权限模型真的很容易让人踩坑，尤其是要访问应用沙箱之外的文件时。你猜的完全没错，就是权限限制在搞鬼！直接用完整路径或者普通方式初始化BitmapImage肯定行不通，因为UWP默认只能访问自己沙箱里的内容（比如Assets目录），而图片库属于系统级的外部存储位置，得按规则来处理才行。

第一步：先配置必要的权限 #

首先得给应用开通访问图片库的权限，不然一切操作都是白搭：

• 打开你的Package.appxmanifest文件
• 切换到「功能」标签页
• 勾选「图片库」选项
• 如果你的应用需要无需用户手动选择就能直接访问整个图片库（而不是单张文件），还要在「受限功能」里添加picturesLibrary权限（注意：提交应用商店时需要说明这个权限的用途）

第二步：正确加载图片的几种实用方法 #

方法1：通过StorageFile加载（适合已知文件路径的场景） #

如果已经知道图片在图片库中的具体路径，绝对不能直接用路径字符串创建BitmapImage，得先通过StorageFile获取文件实例，再转换成流来加载：

using Windows.Storage;
using Windows.Storage.Streams;
using Windows.UI.Xaml.Media.Imaging;

// 示例：加载图片库根目录下的test.jpg
string imageFileName = "test.jpg";
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;
StorageFile imageFile = await picturesFolder.GetFileAsync(imageFileName);

// 打开文件流并加载到BitmapImage
using (IRandomAccessStream stream = await imageFile.OpenAsync(FileAccessMode.Read))
{
    BitmapImage bitmapImage = new BitmapImage();
    await bitmapImage.SetSourceAsync(stream);
    // 把bitmapImage赋值给你的Image控件
    YourImageControl.Source = bitmapImage;
}

方法2：MVVM场景下的绑定加载 #

如果用MVVM模式开发，不能直接绑定文件路径，得绑定StorageFile对象，再配合转换器来处理：

1. 先写一个文件转BitmapImage的转换器：

using Windows.Storage;
using Windows.Storage.Streams;
using Windows.UI.Xaml.Data;
using Windows.UI.Xaml.Media.Imaging;

public class StorageFileToBitmapImageConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, string language)
    {
        if (value is StorageFile file)
        {
            BitmapImage bitmap = new BitmapImage();
            // 异步加载图片（这里用_忽略返回值，不影响UI）
            _ = LoadImageAsync(bitmap, file);
            return bitmap;
        }
        return null;
    }

    private async Task LoadImageAsync(BitmapImage bitmap, StorageFile file)
    {
        using (IRandomAccessStream stream = await file.OpenAsync(FileAccessMode.Read))
        {
            await bitmap.SetSourceAsync(stream);
        }
    }

    public object ConvertBack(object value, Type targetType, object parameter, string language)
    {
        throw new NotImplementedException();
    }
}

2. 在XAML中引用转换器并绑定：

<Page.Resources>
    <!-- 这里的local是你的项目命名空间 -->
    <local:StorageFileToBitmapImageConverter x:Key="FileToImageConverter"/>
</Page.Resources>

<!-- 绑定ViewModel中的StorageFile属性 -->
<Image Source="{Binding TargetImageFile, Converter={StaticResource FileToImageConverter}}"/>

方法3：用FileOpenPicker让用户选择图片（适合需要用户手动选择的场景） #

如果不确定图片的具体路径，让用户自己选择是最稳妥的方式——而且这种方式不需要额外配置图片库权限，因为是用户主动发起的操作，UWP会自动授权访问选中的文件：

FileOpenPicker picker = new FileOpenPicker();
picker.ViewMode = PickerViewMode.Thumbnail;
picker.SuggestedStartLocation = PickerLocationId.PicturesLibrary;
// 筛选支持的图片格式
picker.FileTypeFilter.Add(".jpg");
picker.FileTypeFilter.Add(".jpeg");

StorageFile selectedFile = await picker.PickSingleFileAsync();
if (selectedFile != null)
{
    using (IRandomAccessStream stream = await selectedFile.OpenAsync(FileAccessMode.Read))
    {
        BitmapImage bitmapImage = new BitmapImage();
        await bitmapImage.SetSourceAsync(stream);
        YourImageControl.Source = bitmapImage;
    }
}

为什么之前的方法会失败？ #

• 直接绑定完整路径：UWP的沙箱机制严格限制了应用对外部文件的访问，直接用路径字符串的话，Image控件根本没有权限解析这个路径对应的文件
• 直接用Uri初始化BitmapImage：和上面的问题一样，Uri指向的是沙箱外的文件，没有权限访问，所以加载失败，控件自然就空白了

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