如何判断WinUI 3中当前线程是否为UI线程？

WinUI 3 弃用了 UWP 中依赖 CoreDispatcher 和 CoreWindow 的旧方式，改用 DispatcherQueue 作为线程调度的核心API，以下是两种可靠的断言实现方式：

方法一：基于当前线程的DispatcherQueue访问权限判断 #

这种方式无需依赖全局窗口实例，适用于大多数场景：

using Microsoft.UI.Dispatching;
using System;

public static class ThreadAssertions
{
    public static void AssertOnUIThread()
    {
        DispatcherQueue currentQueue = DispatcherQueue.GetForCurrentThread();
        
        if (currentQueue == null)
        {
            throw new InvalidOperationException("此函数必须在UI线程调用：当前线程无关联的DispatcherQueue");
        }

        if (!currentQueue.HasThreadAccess)
        {
            throw new InvalidOperationException("此函数必须在UI线程调用：当前线程无UI队列访问权限");
        }
    }
}

调用时只需在目标函数开头加入：

public void MyUIFunction()
{
    ThreadAssertions.AssertOnUIThread();
    // 后续UI相关逻辑
}

方法二：基于主UI线程DispatcherQueue的实例比对 #

如果需要明确绑定到应用的主UI线程（比如多窗口场景），可以通过CoreApplication获取主视图的DispatcherQueue进行比对：

using Microsoft.UI.Dispatching;
using Windows.ApplicationModel.Core;
using System;

public static class ThreadAssertions
{
    public static void AssertOnMainUIThread()
    {
        DispatcherQueue uiQueue = CoreApplication.MainView?.DispatcherQueue;
        
        if (uiQueue == null)
        {
            throw new InvalidOperationException("无法获取主UI线程的DispatcherQueue");
        }

        DispatcherQueue currentQueue = DispatcherQueue.GetForCurrentThread();
        if (currentQueue != uiQueue)
        {
            throw new InvalidOperationException("此函数必须在主UI线程调用");
        }
    }
}

注意事项 #

• 类库开发建议优先使用方法一，或让调用者主动传入目标UI线程的DispatcherQueue实例，避免依赖全局窗口对象（多窗口应用中可能存在多个UI线程）。
• HasThreadAccess是WinUI 3官方推荐的线程校验属性，它会直接检查当前线程是否为DispatcherQueue关联的线程，性能开销极低。

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