如何在其他线程独立类中调用WPF MainWindow类方法更新UI

问题本质 #

WPF的UI控件属于单线程亲和模型，所有控件的属性修改操作只能在创建控件的UI线程执行，运行在独立工作线程的Server逻辑直接调用MainWindow的控件更新方法，会抛出跨线程访问异常。

推荐实现（低耦合版本） #

不要将MainWindow实例直接传入Server类造成强耦合，采用事件通知+Dispatcher调度的方式实现，代码可维护性更高。

1. 修改Server类，添加状态通知事件 #

Server类只负责在自身状态变化时触发事件，不需要感知UI层的存在：

public class Server
{
    // 定义状态更新事件，用于向外传递需要展示的信息
    public event Action<string> OnMessageUpdate;
    public event Action<string> OnAddressUpdate;

    public void Start()
    {
        var serverTask = new Task(ExecuteServer);
        serverTask.Start();
    }

    /// <summary>
    /// 运行TCP服务端逻辑
    /// </summary>
    public void ExecuteServer()
    {
        IPHostEntry ipHost = Dns.GetHostEntry(Dns.GetHostName());
        IPAddress ipAddr = ipHost.AddressList[0];
        IPEndPoint localEndPoint = new IPEndPoint(ipAddr, 11111);

        try
        {
            Socket listener = new Socket(ipAddr.AddressFamily,
               SocketType.Stream, ProtocolType.Tcp);
            
            // 初始化完成后触发事件通知UI更新
            OnMessageUpdate?.Invoke("服务启动成功，等待客户端连接");
            OnAddressUpdate?.Invoke($"{ipAddr}:11111");

            listener.Bind(localEndPoint);
            listener.Listen(10);
            while (true)
            {
                // 注意：原代码直接调用AcceptAsync未await，拿到的是Task对象而非Socket实例，会导致后续逻辑出错，同步场景直接用Accept即可
                Socket clientSocket = listener.Accept();
                var receiveThread = new Thread(() => ReceiveAndEnqueueCommand(clientSocket, listener));
                receiveThread.Start();

                OnMessageUpdate?.Invoke("检测到新的客户端连接");
            }
        }
        catch (Exception e)
        {
            OnMessageUpdate?.Invoke($"服务运行异常：{e.Message}");
            Console.WriteLine(e.ToString());
        }
    }

    // 补全你原有的消息接收方法
    private void ReceiveAndEnqueueCommand(Socket clientSocket, Socket listener)
    {
        // 数据接收、处理逻辑
    }
}

2. 修改MainWindow类，订阅事件并调度到UI线程更新 #

在UI层订阅Server的状态事件，跨线程场景下通过Dispatcher将更新操作调度到UI线程执行：

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
        Server server = new Server();
        // 订阅服务端状态事件
        server.OnMessageUpdate += UpdateMessageFromThread;
        server.OnAddressUpdate += UpdateAddressFromThread;
        server.Start();
    }

    private void UpdateAddressFromThread(string address)
    {
        // 判断当前线程是否为UI线程，是则直接更新，否则调度到UI线程
        if (Dispatcher.CheckAccess())
        {
            Address.Content = address;
        }
        else
        {
            Dispatcher.Invoke(() => Address.Content = address);
        }
    }

    private void UpdateMessageFromThread(string message)
    {
        if (Dispatcher.CheckAccess())
        {
            Message.Content = message;
        }
        else
        {
            Dispatcher.Invoke(() => Message.Content = message);
        }
    }

    // 原有更新方法可保留供内部UI线程调用
    public void UpdateMessage(string message)
    {
        Message.Content = message;
    }

    public void UpdateAddress(string address)
    {
        Address.Content = address;
    }
}

注意事项 #

• 不推荐直接将MainWindow实例作为参数传入Server类调用更新方法，这种写法会造成业务层和UI层强耦合，后续修改UI或者做单元测试都会非常麻烦，还容易因为引用持有不当造成内存泄漏。
• Dispatcher.Invoke是同步等待UI线程执行完成，Dispatcher.BeginInvoke是异步将操作排入UI线程队列，可根据实际场景选择。
• 如果使用.NET Core 3.0+版本，也可以用DispatcherQueue实现调度，但WPF原生的Dispatcher已经完全满足当前场景需求。

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