在Windows Forms应用中调用WinRT/UWP成像API遇线程异常问题

我尝试在Windows Forms应用中调用WinRT/UWP的成像API（如BitmapImage），但始终抛出以下异常：

The application called an interface that was marshalled for a different thread, HRESULT:0x8001010E(RPC_E_WRONG_THREAD)

网上搜索结果显示这通常和后台线程调用API有关，但我是在主线程中执行的代码。

代码示例 #

async private void button1_Click(object sender, EventArgs e)
{
    try
    {
        // 此API无异常抛出
        var locator = new Windows.Devices.Geolocation.Geolocator();

        // 此成像API触发异常
        var bi = new Windows.UI.Xaml.Media.Imaging.BitmapImage();
    }
    catch (Exception ee){}
}

环境信息 #

• 测试环境：VS2017、VS2019
• 项目类型：空白Windows Forms应用（VS2019使用.NET Framework 4.8，VS2017使用4.7.2）
• 已添加NuGet包Microsoft.Windows.SDK.Contracts，测试过版本10.0.22621.2和10.0.17134.100

解决方案 #

问题根源在于：WinRT的XAML类（如BitmapImage）依赖XAML框架的UI线程上下文，而Windows Forms的主线程虽然是UI线程，但未初始化XAML的线程环境，因此即使在同一线程创建实例也会触发线程异常。

方案1：初始化XAML线程上下文并调度创建操作

在应用启动时初始化XAML核心环境，然后通过DispatcherQueue调度BitmapImage的创建操作：

using Windows.ApplicationModel.Core;
using Windows.UI.Core;

// 在Program.cs的Main方法中添加（应用启动时执行）
CoreApplication.EnablePrelaunch(false);

// 修改按钮点击事件代码
async private void button1_Click(object sender, EventArgs e)
{
    try
    {
        var locator = new Windows.Devices.Geolocation.Geolocator();

        // 获取当前线程的DispatcherQueue，若无则初始化
        var dispatcherQueue = DispatcherQueue.GetForCurrentThread();
        if (dispatcherQueue == null)
        {
            CoreApplication.CreateNewView();
            dispatcherQueue = DispatcherQueue.GetForCurrentThread();
        }

        // 在DispatcherQueue中执行BitmapImage创建操作
        await dispatcherQueue.TryEnqueue(() =>
        {
            var bi = new Windows.UI.Xaml.Media.Imaging.BitmapImage();
            // 后续图像操作逻辑
        });
    }
    catch (Exception ee)
    {
        // 异常处理逻辑
    }
}

方案2：改用非XAML的WinRT成像API

如果只是处理图像解码、像素操作等需求，无需使用XAML的BitmapImage，可以改用WinRT的BitmapDecoder类，它不依赖XAML线程环境：

using Windows.Graphics.Imaging;
using Windows.Storage;

async private void button1_Click(object sender, EventArgs e)
{
    try
    {
        var locator = new Windows.Devices.Geolocation.Geolocator();

        // 示例：读取本地图像文件并解码
        var imageFile = await StorageFile.GetFileFromPathAsync(@"C:\example.jpg");
        using (var fileStream = await imageFile.OpenAsync(FileAccessMode.Read))
        {
            var decoder = await BitmapDecoder.CreateAsync(fileStream);
            // 获取图像像素数据
            var pixelData = await decoder.GetPixelDataAsync();
            // 后续处理逻辑
        }
    }
    catch (Exception ee)
    {
        // 异常处理逻辑
    }
}

方案3：使用WinForms原生成像类

如果不需要WinRT API的特性，直接使用WinForms原生的System.Drawing.Bitmap类，完全适配WinForms线程环境，不会有线程问题。

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