WPF/UWP Image 控件 Binding 圖片路徑不顯示：Uri 協議、相對路徑、BitmapImage 完整解析

問題核心

`` 其中 `ItemName = @"C:\Data\...\xxx.jpg"` **絕對路徑字符串無法直接被 WPF/UWP 解析為圖片來源**。

根因

• WPF/UWP `Image.Source` 類型為 `ImageSource` (通常是 `BitmapImage`)，**不支援直接綁定 `string` 路徑**
• 需顯式轉換為 `BitmapImage` 或使用 `Uri` 且帶協議前綴 (`file:///`)
• UWP 沙箱機制**禁止直接訪問 `C:\` 絕對路徑**，必須通過 `FileOpenPicker` 或 `StorageFile` 獲取權限

解決方案 (WPF 桌面端)

方案一：ViewModel 直接暴露 BitmapImage (最簡單)

public class ViewModel : INotifyPropertyChanged {
    private string _itemName;
    public string ItemName {
        get => _itemName;
        set { _itemName = value; OnPropertyChanged(); OnPropertyChanged(nameof(ItemImage)); }
    }
    public BitmapImage ItemImage {
        get {
            if (string.IsNullOrEmpty(_itemName) || !File.Exists(_itemName)) return null;
            var bmp = new BitmapImage();
            bmp.BeginInit();
            bmp.CacheOption = BitmapCacheOption.OnLoad; // 釋放文件鎖定
            bmp.UriSource = new Uri(_itemName, UriKind.Absolute);
            bmp.EndInit();
            bmp.Freeze(); // 跨線程可用
            return bmp;
        }
    }
}

方案二：IValueConverter 統一轉換 (可複用)

[ValueConversion(typeof(string), typeof(BitmapImage))]
public class PathToImageConverter : IValueConverter {
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture) {
        if (value is string path && File.Exists(path)) {
            var bmp = new BitmapImage();
            bmp.BeginInit();
            bmp.CacheOption = BitmapCacheOption.OnLoad;
            bmp.UriSource = new Uri(path);
            bmp.EndInit();
            bmp.Freeze();
            return bmp;
        }
        return DependencyProperty.UnsetValue;
    }
    public object ConvertBack(...) => throw new NotSupportedException();
}

解決方案 (UWP / WinUI 3)

**不能直接用絕對路徑**。必須：

1. 用 `FileOpenPicker` 讓用戶選擇 → 獲取 `StorageFile`
2. 或將圖片複製到 `ApplicationData.Current.LocalFolder`
3. 綁定 `StorageFile` → Converter 用 `SetSourceAsync`：

public class StorageFileToImageConverter : IValueConverter {
    public async object Convert(object value, Type targetType, object parameter, string language) {
        if (value is StorageFile file) {
            var bmp = new BitmapImage();
            using (var stream = await file.OpenReadAsync()) {
                await bmp.SetSourceAsync(stream);
            }
            return bmp;
        }
        return null;
    }
    // ConvertBack 不實現
}

常見坑點速查

總結

**WPF：Converter + BitmapImage.OnLoad + Freeze**；**UWP：StorageFile + SetSourceAsync**。絕不直接綁定字符串路徑。