如何解决BitmapImage加载Web资源时下载完成通知失效问题？

你遇到的问题核心在于：BitmapImage的异步下载完全依赖当前线程的Dispatcher。你在Task.Run的后台线程中创建并初始化BitmapImage，而后台线程没有WPF的Dispatcher消息循环，导致异步下载流程根本无法启动，自然不会触发DownloadCompleted或DownloadFailed事件。WPF的Image控件能正常工作，是因为它在UI线程中使用BitmapImage，UI线程自带Dispatcher可以调度异步下载和事件回调。

另外，你用EventWaitHandle配合Task.Run(handle.WaitOne)的方式不仅冗余，还可能因为线程上下文问题加剧事件触发失败的概率。

方案一：用HttpClient下载流后加载（推荐） #

这种方式完全可控，不依赖BitmapImage的内置异步机制，适合后台加载后冻结跨线程传递的场景：

public static async Task<BitmapImage> LoadBitmapFromUriAsync(Uri uri)
{
    // 用HttpClient异步下载图像流
    using var httpClient = new HttpClient();
    using var stream = await httpClient.GetStreamAsync(uri);

    // 加载流到BitmapImage并冻结
    var bitmap = new BitmapImage();
    bitmap.BeginInit();
    bitmap.CacheOption = BitmapCacheOption.OnLoad; // 确保加载完成后缓存，释放流
    bitmap.StreamSource = stream;
    bitmap.EndInit();
    bitmap.Freeze(); // 冻结后可安全跨线程传递到UI线程

    return bitmap;
}

方案二：在UI线程初始化BitmapImage并监听事件 #

如果你必须用BitmapImage的内置事件，需要确保在UI线程初始化它，再用TaskCompletionSource包装事件回调，避免阻塞UI线程：

public static Task<BitmapImage> LoadBitmapWithEventsAsync(Uri uri)
{
    var tcs = new TaskCompletionSource<BitmapImage>();
    var bitmap = new BitmapImage();

    void Cleanup()
    {
        bitmap.DownloadCompleted -= OnCompleted;
        bitmap.DownloadFailed -= OnFailed;
    }

    void OnCompleted(object sender, EventArgs e)
    {
        Cleanup();
        bitmap.Freeze();
        tcs.SetResult(bitmap);
    }

    void OnFailed(object sender, ExceptionEventArgs e)
    {
        Cleanup();
        tcs.SetException(e.ErrorException);
    }

    bitmap.DownloadCompleted += OnCompleted;
    bitmap.DownloadFailed += OnFailed;

    bitmap.BeginInit();
    bitmap.UriSource = uri;
    bitmap.EndInit();

    // 如果已经下载完成，直接返回
    if (!bitmap.IsDownloading)
    {
        Cleanup();
        bitmap.Freeze();
        tcs.SetResult(bitmap);
    }

    return tcs.Task;
}

注意：这个方法需要在UI线程调用，因为BitmapImage的初始化依赖UI线程的Dispatcher。如果要在后台线程触发，可以用Application.Current.Dispatcher.Invoke来执行初始化逻辑。

• 如果你需要支持本地文件和Web链接，只需在方法里判断Uri的Scheme：uri.IsFile时直接用文件流加载，否则用HttpClient。
• 冻结BitmapImage是跨线程传递的关键，冻结后的对象是只读的，可以安全在UI线程使用。

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