WPF中如何将Image.Source绑定到含变音符号的文件名？

最近我碰到一个WPF绑定图片的坑：用相对路径绑定带变音符号的图片时，Content类型的资源死活加载不出来，折腾了半天终于找到了解决办法，分享给大家。

问题场景 #

我用以下XAML绑定两张图片的Source：

<StackPanel>
  <Image Source="{Binding Image1}" />
  <Image Source="{Binding Image2}" />
</StackPanel>

对应的DataContext代码是：

public string Image1 { get; set; } = "/test.png";
public string Image2 { get; set; } = "/testä.png";

两张图片的生成操作都设置为Content，并勾选了Copy if newer。结果运行时Image1正常显示，Image2却完全看不到，输出窗口还抛出了错误：

'TargetDefaultValueConverter'转换器无法转换值'/testä.png'（类型'String'）；若有可用回退值则会使用。BindingExpression:Path=Image2; DataItem='MainWindow' (Name=''); target element is 'Image' (Name=''); target property is 'Source' (type 'ImageSource') IOException:'System.IO.IOException: 无法找到资源"test%c3%a4.png"。

我尝试过查找Unicode字符在XAML中的处理方案，但没起作用。后来发现一个关键细节：绑定Image1时，/test.png会被自动转换为pack://application:,,,/WpfImageBindingUmlauts;component/test.png——WPF并不是去文件系统找文件，而是按资源路径解析的。

问题根源 #

当图片设为Content类型时，WPF解析带变音符号的相对路径时，会把Unicode字符做URL编码（比如ä变成%c3%a4），但实际部署后文件的名称还是testä.png，编码后的路径自然找不到对应的文件，所以加载失败。

亲测有效的两种解决方案 #

方案1：使用完整文件路径强制读取文件系统

直接给图片路径赋值完整的本地文件路径，比如：

public string Image2 { get; set; } = @"C:\testä.png";

这种方式会让WPF跳过资源路径解析，直接从文件系统加载图片，带变音符号的文件名可以正常识别。不过要注意，在ClickOnce部署时，得确保文件的部署路径和代码里的路径一致，避免找不到文件。

方案2：将生成操作改为Resource

把图片的生成操作从Content改成Resource，不需要修改任何绑定代码，原有的相对路径就能正常加载带变音符号的图片。

• 原理：Resource类型的资源会被嵌入到程序集当中，WPF解析路径时不会对文件名做URL编码，直接从程序集资源里找原名称的文件，自然就能匹配到testä.png。
• 关于ClickOnce部署的顾虑：原本用Content是为了把图片包含进ClickOnce包，其实Resource类型的资源同样会被打包进去，完全能满足部署需求，不用担心这个问题。

内容的提问来源于stack exchange，提问作者sa.he