WPF .NET4.8自定义启动屏图片无法渲染问题求助

问题背景 #

在.NET 4.8环境下用C#开发WPF自定义启动屏，该启动屏位于独立类库中，用于展示启动图片并动态更新加载提示。核心实现逻辑：

• 启动屏类库：
  • Window（XAML）：Image控件绑定ConfigModel.DisplayedImage作为Source
  • Window（CS）：构造函数接收图片路径，将ViewModel设为DataContext
  • ViewModel：根据传入路径加载图片，路径为空则加载默认图，通过ImagesUtilities.LoadBitmapImageFromPath方法创建BitmapImage
  • 图片加载：使用相对Uri创建BitmapImage
• 主应用：在OnStartup中创建启动屏实例，通过Task启动并调用Dispatcher显示启动屏，加载完成后切换主窗口并关闭启动屏

问题现象 #

启动应用时，启动屏正常显示但图片加载失败；若在SetSplashScreen方法末尾设断点，将图片的Height加入监视窗口，运行到断点后继续执行，会先抛出异常，再次点击继续后启动屏图片能正常显示。

图片文件（默认图和应用图均为PNG）的编译属性设置为Content，复制输出目录设为Copy if newer。

问题分析 #

结合现象推测核心原因：

1. BitmapImage延迟加载机制：BitmapImage默认采用延迟加载，未触发实际加载逻辑时不会读取图片文件，断点监视Height属性强制触发了加载，因此后续能正常显示。
2. 线程上下文不匹配：通过Task启动启动屏时，BitmapImage可能在非UI线程创建，导致跨线程绑定异常，断点后调度到正确线程才完成加载。
3. 相对Uri路径错误：类库与主应用的输出目录结构差异，导致相对Uri无法正确定位图片文件。

解决方案 #

1. 修正图片路径的Uri创建方式 #

确保路径能正确指向输出目录中的图片，推荐使用基于应用程序基目录的绝对Uri，类库内的默认图使用pack://格式：

public static BitmapImage LoadBitmapImageFromPath(string imagePath)
{
    if (string.IsNullOrEmpty(imagePath))
    {
        // 类库默认图的pack路径，替换为你的类库名称和图片相对路径
        imagePath = "pack://application:,,,/YourSplashScreenLib;component/Images/DefaultSplash.png";
    }
    else
    {
        // 转换为基于应用基目录的绝对路径
        var fullPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, imagePath);
        imagePath = new Uri(fullPath).AbsoluteUri;
    }

    var bitmap = new BitmapImage();
    bitmap.BeginInit();
    bitmap.UriSource = new Uri(imagePath);
    bitmap.CacheOption = BitmapCacheOption.OnLoad; // 强制立即加载
    bitmap.EndInit();
    return bitmap;
}

2. 强制BitmapImage立即加载并冻结 #

设置BitmapCacheOption.OnLoad强制立即读取图片，同时调用Freeze()允许跨线程访问：

var bitmap = new BitmapImage();
bitmap.BeginInit();
bitmap.UriSource = new Uri(imagePath);
bitmap.CacheOption = BitmapCacheOption.OnLoad;
bitmap.EndInit();
bitmap.Freeze(); // 冻结对象，避免跨线程访问异常
return bitmap;

3. 确保启动屏在UI线程创建和显示 #

避免在Task中直接创建Window，通过UI线程的Dispatcher调度加载逻辑：

protected override void OnStartup(StartupEventArgs e)
{
    base.OnStartup(e);
    
    // 直接在UI线程创建启动屏
    var splashScreen = new SplashScreenWindow("Splash.png");
    
    Task.Run(() =>
    {
        // 模拟应用初始化逻辑
        PerformAppInitialization();
        
        // 加载完成后切换主窗口（调度回UI线程）
        Application.Current.Dispatcher.Invoke(() =>
        {
            splashScreen.Close();
            new MainWindow().Show();
        });
    });
    
    // UI线程显示启动屏
    splashScreen.Show();
}

4. 验证图片编译属性与输出路径 #

• 确认图片的Copy to Output Directory设为Copy always，避免首次编译或更新时未复制文件
• 检查输出目录中是否存在对应图片，确保代码中的路径与实际输出路径一致

5. 手动触发图片加载逻辑 #

如果延迟加载问题仍存在，可在ViewModel的属性 setter 中手动触发加载：

private BitmapImage _displayedImage;
public BitmapImage DisplayedImage
{
    get => _displayedImage;
    set
    {
        _displayedImage = value;
        OnPropertyChanged();
        
        // 手动访问PixelHeight强制触发加载
        if (_displayedImage != null)
        {
            var dummy = _displayedImage.PixelHeight;
        }
    }
}

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