C# WPF实现Arduino串口数据接收跨线程更新UI文本框方法

WPF的UI控件有严格的线程亲和性，只有创建控件的UI线程能直接操作控件属性。SerialPort的DataReceived事件默认在独立的后台工作线程触发，直接在该事件里给TextBox赋值会抛出跨线程访问异常，所有UI更新操作必须调度到UI线程的Dispatcher队列执行，完整实现步骤如下：

1. 基础准备 #

先引入必要命名空间，在窗口类中声明全局串口实例，避免频繁创建销毁导致的资源泄漏：

using System.IO.Ports;
using System.Text;
using System.Windows;
using System.Windows.Threading;

public partial class MainWindow : Window
{
    private SerialPort _serialPort;
    public MainWindow()
    {
        InitializeComponent();
        Loaded += MainWindow_Loaded;
        Closed += MainWindow_Closed;
    }
}

界面端的TextBox提前配置基础属性，方便接收数据展示，参考XAML写法：

<TextBox 
    x:Name="ReceiveTextBox" 
    IsReadOnly="True" 
    AcceptsReturn="True"
    VerticalScrollBarVisibility="Auto"
    HorizontalScrollBarVisibility="Auto"
/>

2. 初始化串口、绑定接收事件 #

在窗口加载逻辑里配置串口参数（端口号、波特率等按实际硬件参数修改），绑定数据接收事件，做好打开异常捕获：

private void MainWindow_Loaded(object sender, RoutedEventArgs e)
{
    _serialPort = new SerialPort
    {
        PortName = "COM3",
        BaudRate = 9600,
        Parity = Parity.None,
        DataBits = 8,
        StopBits = StopBits.One,
        ReadTimeout = 500
    };
    // 绑定接收事件，事件触发时运行在后台线程
    _serialPort.DataReceived += SerialPort_DataReceived;
    
    try
    {
        _serialPort.Open();
    }
    catch (Exception ex)
    {
        MessageBox.Show($"串口打开失败：{ex.Message}");
    }
}

3. 实现跨线程接收更新逻辑 #

注意不要在DataReceived事件里直接操作UI控件：先在后台线程把串口缓冲区的数据读完（避免UI卡顿导致缓冲区溢出丢数），再通过Dispatcher把UI更新逻辑调度到UI线程执行。优先用BeginInvoke异步调度，不要阻塞串口接收线程：

private void SerialPort_DataReceived(object sender, SerialDataReceivedEventArgs e)
{
    // 后台线程完成数据读取，不占用UI线程时间
    int byteCount = _serialPort.BytesToRead;
    byte[] buffer = new byte[byteCount];
    _serialPort.Read(buffer, 0, byteCount);
    // 按硬件实际输出编码转换字符串，中文场景一般用GB2312
    string recvStr = Encoding.ASCII.GetString(buffer);

    // 调度到UI线程更新控件，优先用Application全局Dispatcher避免空引用
    Application.Current.Dispatcher.BeginInvoke(new Action(() =>
    {
        ReceiveTextBox.AppendText($"[{DateTime.Now:HH:mm:ss.fff}] {recvStr}{Environment.NewLine}");
        ReceiveTextBox.ScrollToEnd();
    }), DispatcherPriority.Background);
}

避坑提示：如果业务需要按协议解析完整数据帧，不要假设一次DataReceived就能收到完整数据，需要自己定义内存缓存拼接多次收到的字节，按帧头帧尾校验后再做业务处理。

4. 资源释放 #

窗口关闭时必须解绑事件、关闭并释放串口资源，避免程序退出后串口被持续占用：

private void MainWindow_Closed(object sender, EventArgs e)
{
    if (_serialPort == null) return;
    _serialPort.DataReceived -= SerialPort_DataReceived;
    if (_serialPort.IsOpen) _serialPort.Close();
    _serialPort.Dispose();
}

常见问题排查 #

• 出现跨线程访问异常：检查所有操作UI控件的代码，是否全部放到了Dispatcher的委托内部
• 接收数据乱码：检查字符串转码时用的编码是否和硬件发送端编码一致
• 丢数据：不要在DataReceived事件里写耗时逻辑（比如数据库操作、复杂计算），读串口数据的逻辑不要放到UI调度委托里

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