Modbus C# 第四天:WinForms 界面

这是系列第四篇。前三天的代码,你都是在黑窗口(控制台)里跑的。

今天要做一个带窗口、带按钮的程序——这才像真正的上位机。

这一篇我会写清楚:点哪个菜单、拖哪个控件、改哪个属性、代码写在哪一行。


第一部分:新建 WinForms 项目

1.1 打开 Visual Studio

打开你平时用的 Visual Studio。

1.2 新建项目

  1. 点 创建新项目
  2. 在搜索框里输入:Windows 窗体
  3. 在列表里找到 Windows 窗体应用(.NET),图标是紫色,语言是 C#
  4. 点它,再点 下一步

1.3 填项目信息

  • 项目名称:ModbusWinForm
  • 位置:默认就行
  • 框架:选 .NET 6.0 或 .NET 8.0
  • 点 创建

1.4 你会看到什么

创建完之后,屏幕上会出现一个空白窗口,标题写着 Form1。

  • 中间那块空白区域,叫 窗体设计器,是给你拖控件的地方
  • 左边是 工具箱(如果没有,点顶部菜单 视图 → 工具箱)
  • 右下角是 属性窗口(如果没有,点 视图 → 属性窗口)

先确认这三块都能看到。


第二部分:装 NModbus

和前两天一样:

  1. 右侧 解决方案资源管理器 里,右键项目名 ModbusWinForm
  2. 点 管理 NuGet 程序包
  3. 点 浏览,搜索 NModbus
  4. 点它,再点 安装

装好就行,先不管它。


第三部分:拖控件,做出界面

3.1 目标界面

我们要做出这样一个窗口:

┌─────────────────────────────────┐
│  温度:  [          ]  ℃         │
│                                 │
│  [ 启动轮询 ]  [ 停止轮询 ]      │
│                                 │
│  状态:未连接                    │
└─────────────────────────────────┘

3.2 加第一个 Label(显示“温度:”)

  1. 左边 工具箱 里,找到 Label(图标是 A)
  2. 用鼠标按住它,拖到窗体上,松开
  3. 窗体上会出现一个 label1

改它的文字和名字:

  1. 点中窗体上的 label1
  2. 看右下角 属性 窗口
  3. 找到 Text 属性,把 label1 改成 温度:
  4. 找到 (Name) 属性,把 label1 改成 lblTemperature

改完,窗体上这个 Label 就显示“温度:”。

3.3 加一个 TextBox(显示温度值)

  1. 工具箱里找到 TextBox
  2. 拖到窗体上
  3. 它会显示一个空白的输入框

改名字:

  1. 点中这个 TextBox
  2. 属性窗口里找到 (Name),把 textBox1 改成 txtTemperature
  3. 找到 ReadOnly,改成 True(这样用户不能手打)

为什么改名字:代码里要用这个名字操作这个框。名字清楚,代码才看得懂。

3.4 加一个 Label(显示“℃”)

  1. 拖一个 Label 到窗体上
  2. Text 属性改成 ℃
  3. (Name) 属性改成 lblUnit

3.5 加“启动轮询”按钮

  1. 工具箱里找到 Button
  2. 拖到窗体上

改属性:

  1. Text 改成 启动轮询
  2. (Name) 改成 btnStart

3.6 加“停止轮询”按钮

  1. 再拖一个 Button 到窗体上
  2. Text 改成 停止轮询
  3. (Name) 改成 btnStop

3.7 加“状态”标签

  1. 拖一个 Label 到窗体上
  2. Text 改成 状态:未连接
  3. (Name) 改成 lblStatus

3.8 加 Timer(定时器)

这一步很容易懵,仔细看。

  1. 工具箱里找到 Timer
  2. 拖到窗体上

注意:Timer 拖上去后,不在窗体里面,而是在窗体下方的一条独立区域里(叫“组件栏”)。

如果你没看到它,拖上去后在窗体下方找一找。

改属性:

  1. 点中这个 Timer(在下面那条区域里)
  2. (Name) 改成 timer1
  3. Interval 改成 1000(毫秒,1000 = 1 秒)

3.9 现在的界面

拖动一下控件,排整齐:

┌─────────────────────────────────┐
│  温度: [          ] ℃          │
│                                 │
│  [ 启动轮询 ]  [ 停止轮询 ]      │
│                                 │
│  状态:未连接                    │
└─────────────────────────────────┘

先把界面做出来,别急着写代码。


第四部分:双击按钮,写代码

4.1 双击“启动轮询”按钮

  1. 用鼠标双击窗体上的 “启动轮询”按钮
  2. Visual Studio 会自动跳到代码界面
  3. 光标停在一个自动生成的方法里:
private void btnStart_Click(object sender, EventArgs e)
{

}

这个方法就是:点击按钮时执行的代码。你直接往里面写就行。

4.2 双击 Timer

  1. 点顶部标签页回到 窗体设计器(Form1.cs [设计])
  2. 用鼠标双击窗体下方那个 Timer
  3. Visual Studio 又跳回代码界面,生成:
private void timer1_Tick(object sender, EventArgs e)
{

}

这个是:每隔 1 秒执行一次的代码。

4.3 双击“停止轮询”按钮

  1. 回到窗体设计器
  2. 双击“停止轮询”按钮
  3. 生成:
private void btnStop_Click(object sender, EventArgs e)
{

}

现在你有三个空方法,等会儿分别填代码。


第五部分:写代码

5.1 顶部加 using

点代码文件顶部,在最上面加上这几行:

using System;
using System.Net.Sockets;
using System.Windows.Forms;
using NModbus;

5.2 在类里加两个变量

在代码里找到这一行:

public partial class Form1 : Form

它的下面一般跟着:

public Form1()
{
    InitializeComponent();
}

在 public Form1() 的上面,加两个变量:

public partial class Form1 : Form
{
    // Modbus 主站对象
    private IModbusMaster master;

    // TCP 连接
    private TcpClient client;

    public Form1()
    {
        InitializeComponent();
    }
}

为什么要加在这里:因为按钮点击和定时器都要用到这两个变量,放在类里,两个方法都能访问。

加错位置会怎样:如果加在 public Form1() 里面,其他方法就访问不到,会报错。

5.3 填写“启动轮询”的代码

找到:

private void btnStart_Click(object sender, EventArgs e)
{

}

把大括号里填成这样:

private void btnStart_Click(object sender, EventArgs e)
{
    try
    {
        // 1. 连接设备
        client = new TcpClient("127.0.0.1", 502);
        var factory = new ModbusFactory();
        master = factory.CreateMaster(client);

        // 2. 启动定时器
        timer1.Start();

        // 3. 更新状态
        lblStatus.Text = "状态:已连接,正在轮询";
    }
    catch (Exception ex)
    {
        MessageBox.Show("连接失败:" + ex.Message);
    }
}

逐行解释:

代码 意思
new TcpClient("127.0.0.1", 502) 连到本机 502 端口(Modbux)
factory.CreateMaster(client) 创建主站
timer1.Start() 启动定时器,每秒触发一次
lblStatus.Text = "..." 改状态栏文字
MessageBox.Show(...) 弹出一个对话框显示错误
catch (Exception ex) 出错时走这里,程序不会崩

5.4 填写 Timer 的代码

找到:

private void timer1_Tick(object sender, EventArgs e)
{

}

填成这样:

private void timer1_Tick(object sender, EventArgs e)
{
    try
    {
        // 1. 读 2 个寄存器
        ushort[] registers = master.ReadHoldingRegisters(2, 0, 2);

        // 2. 拼成 float
        float value = ConvertToFloat(registers);

        // 3. 显示到文本框,保留 1 位小数
        txtTemperature.Text = value.ToString("F1");
    }
    catch (Exception ex)
    {
        lblStatus.Text = "状态:读取失败 - " + ex.Message;
    }
}

逐行解释:

代码 意思
ReadHoldingRegisters(2, 0, 2) 读 2 号从站,从地址 0 开始,读 2 个寄存器
ConvertToFloat(registers) 拼成 float(第三天学的方法)
txtTemperature.Text = ... 把值显示到文本框
.ToString("F1") 转成字符串,保留 1 位小数
catch 出错就显示错误到状态栏

5.5 填写“停止轮询”的代码

找到:

private void btnStop_Click(object sender, EventArgs e)
{

}

填成这样:

private void btnStop_Click(object sender, EventArgs e)
{
    // 1. 停止定时器
    timer1.Stop();

    // 2. 关掉连接
    if (client != null)
    {
        client.Close();
    }

    // 3. 更新状态
    lblStatus.Text = "状态:已停止";
}

逐行解释:

代码 意思
timer1.Stop() 停止定时器,不再每秒读
client.Close() 关掉 TCP 连接
lblStatus.Text = ... 更新状态文字

5.6 加上 ConvertToFloat 方法

在 Form1 类里,和按钮方法平级的地方(也就是在 btnStart_Click、timer1_Tick、btnStop_Click 这几个方法的外面),加上:

private float ConvertToFloat(ushort[] registers)
{
    byte[] bytes = new byte[4];
    bytes[0] = (byte)(registers[0] >> 8);
    bytes[1] = (byte)(registers[0] & 0xFF);
    bytes[2] = (byte)(registers[1] >> 8);
    bytes[3] = (byte)(registers[1] & 0xFF);
    return BitConverter.ToSingle(bytes, 0);
}

这就是第三天学的工具方法,直接拿来用。

放错位置会怎样:如果放在某个按钮方法里面,别的按钮访问不到,会报错。


第六部分:运行前准备

6.1 打开 Modbux

  • 打开 Modbux
  • 进入 SERVER 模式
  • 协议选 TCP,端口 502
  • Unit ID = 2
  • Holding Registers 里手动加两条:
    • 地址 0 = 16844
    • 地址 1 = 52429

这两个值是 25.6 对应的寄存器值(第三天学的)。如果你用 FloatToRegisters 算出来不一样,以你算出来的为准。

6.2 确认 Modbux 在监听

右上角显示 Port 502,TCP 模式。让窗口开着。


第七部分:运行

7.1 按 F5

Visual Studio 会编译并运行,弹出窗体。

7.2 操作

  1. 窗体显示:温度: [ ] ℃,状态:未连接
  2. 点 启动轮询 按钮
  3. 状态变成:状态:已连接,正在轮询
  4. 温度框里显示:25.6
  5. 每秒刷新一次

7.3 测试实时刷新

回到 Modbux,把地址 0 的值改成 16844(不变),把地址 1 改成 52429(不变),先不动。

改成别的值试试:比如把地址 0 改成 0,地址 1 改成 0,窗体里温度会变成 0.0。

改回 16844 和 52429,温度又变回 25.6。

7.4 点“停止轮询”

  • 状态变成:状态:已停止
  • 温度框不再刷新

一个最简单的上位机就做出来了。


第八部分:常见卡住的地方

卡住的现象 原因 解决
找不到工具箱 菜单里没打开 点 视图 → 工具箱
找不到属性窗口 菜单里没打开 点 视图 → 属性窗口
拖 Timer 后找不到它 它在窗体下方那条区域 往下拖,看窗体外面
双击按钮没反应 点在了窗体空白处 要点中按钮本身
改完控件名字,代码里报错 代码里还写着旧名字 把代码里 textBox1 改成 txtTemperature
编译报错“client 未定义” 变量加错位置 确认变量加在 public Form1() 上面
点按钮弹出“连接失败” Modbux 没开 打开 Modbux,确认 Unit ID = 2
温度框一直空 Modbux 里地址 0、1 没设置 手动加地址 0=16844,地址 1=52429
温度显示成天文数字 字节顺序反了 把 ConvertToFloat 里两个寄存器交换
界面卡住 读数据阻塞了 UI 线程 第五天会讲多线程

第九部分:你学到了什么

  1. WinForms 是什么:C# 做 Windows 窗口程序
  2. 拖控件:Label、TextBox、Button、Timer
  3. 改控件属性:Text、Name、Interval
  4. 双击控件写代码:按钮点击、Timer 触发
  5. 把 Modbus 和界面结合:读数据 → 显示到文本框
  6. Timer 做轮询:每秒执行一次

第十部分:下一步可以学什么

  • 多线程:解决界面卡顿
  • 多个数据点:同时显示温度、湿度、压力
  • 写数据:加输入框和按钮,把值写回设备
  • 报警:超过阈值标红
  • Modbus RTU:串口通信

最后编辑于 :
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

友情链接更多精彩内容