这是系列第四篇。前三天的代码,你都是在黑窗口(控制台)里跑的。
今天要做一个带窗口、带按钮的程序——这才像真正的上位机。
这一篇我会写清楚:点哪个菜单、拖哪个控件、改哪个属性、代码写在哪一行。
第一部分:新建 WinForms 项目
1.1 打开 Visual Studio
打开你平时用的 Visual Studio。
1.2 新建项目
- 点 创建新项目
- 在搜索框里输入:
Windows 窗体 - 在列表里找到 Windows 窗体应用(.NET),图标是紫色,语言是 C#
- 点它,再点 下一步
1.3 填项目信息
-
项目名称:
ModbusWinForm - 位置:默认就行
-
框架:选
.NET 6.0或.NET 8.0 - 点 创建
1.4 你会看到什么
创建完之后,屏幕上会出现一个空白窗口,标题写着 Form1。
- 中间那块空白区域,叫 窗体设计器,是给你拖控件的地方
- 左边是 工具箱(如果没有,点顶部菜单 视图 → 工具箱)
- 右下角是 属性窗口(如果没有,点 视图 → 属性窗口)
先确认这三块都能看到。
第二部分:装 NModbus
和前两天一样:
- 右侧 解决方案资源管理器 里,右键项目名
ModbusWinForm - 点 管理 NuGet 程序包
- 点 浏览,搜索
NModbus - 点它,再点 安装
装好就行,先不管它。
第三部分:拖控件,做出界面
3.1 目标界面
我们要做出这样一个窗口:
┌─────────────────────────────────┐
│ 温度: [ ] ℃ │
│ │
│ [ 启动轮询 ] [ 停止轮询 ] │
│ │
│ 状态:未连接 │
└─────────────────────────────────┘
3.2 加第一个 Label(显示“温度:”)
- 左边 工具箱 里,找到 Label(图标是
A) - 用鼠标按住它,拖到窗体上,松开
- 窗体上会出现一个
label1
改它的文字和名字:
- 点中窗体上的
label1 - 看右下角 属性 窗口
- 找到 Text 属性,把
label1改成温度: - 找到 (Name) 属性,把
label1改成lblTemperature
改完,窗体上这个 Label 就显示“温度:”。
3.3 加一个 TextBox(显示温度值)
- 工具箱里找到 TextBox
- 拖到窗体上
- 它会显示一个空白的输入框
改名字:
- 点中这个 TextBox
- 属性窗口里找到 (Name),把
textBox1改成txtTemperature - 找到 ReadOnly,改成
True(这样用户不能手打)
为什么改名字:代码里要用这个名字操作这个框。名字清楚,代码才看得懂。
3.4 加一个 Label(显示“℃”)
- 拖一个 Label 到窗体上
-
Text 属性改成
℃ -
(Name) 属性改成
lblUnit
3.5 加“启动轮询”按钮
- 工具箱里找到 Button
- 拖到窗体上
改属性:
-
Text 改成
启动轮询 -
(Name) 改成
btnStart
3.6 加“停止轮询”按钮
- 再拖一个 Button 到窗体上
-
Text 改成
停止轮询 -
(Name) 改成
btnStop
3.7 加“状态”标签
- 拖一个 Label 到窗体上
-
Text 改成
状态:未连接 -
(Name) 改成
lblStatus
3.8 加 Timer(定时器)
这一步很容易懵,仔细看。
- 工具箱里找到 Timer
- 拖到窗体上
注意:Timer 拖上去后,不在窗体里面,而是在窗体下方的一条独立区域里(叫“组件栏”)。
如果你没看到它,拖上去后在窗体下方找一找。
改属性:
- 点中这个 Timer(在下面那条区域里)
-
(Name) 改成
timer1 -
Interval 改成
1000(毫秒,1000 = 1 秒)
3.9 现在的界面
拖动一下控件,排整齐:
┌─────────────────────────────────┐
│ 温度: [ ] ℃ │
│ │
│ [ 启动轮询 ] [ 停止轮询 ] │
│ │
│ 状态:未连接 │
└─────────────────────────────────┘
先把界面做出来,别急着写代码。
第四部分:双击按钮,写代码
4.1 双击“启动轮询”按钮
- 用鼠标双击窗体上的 “启动轮询”按钮
- Visual Studio 会自动跳到代码界面
- 光标停在一个自动生成的方法里:
private void btnStart_Click(object sender, EventArgs e)
{
}
这个方法就是:点击按钮时执行的代码。你直接往里面写就行。
4.2 双击 Timer
- 点顶部标签页回到 窗体设计器(
Form1.cs [设计]) - 用鼠标双击窗体下方那个 Timer
- Visual Studio 又跳回代码界面,生成:
private void timer1_Tick(object sender, EventArgs e)
{
}
这个是:每隔 1 秒执行一次的代码。
4.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
- 地址 0 =
这两个值是
25.6对应的寄存器值(第三天学的)。如果你用FloatToRegisters算出来不一样,以你算出来的为准。
6.2 确认 Modbux 在监听
右上角显示 Port 502,TCP 模式。让窗口开着。
第七部分:运行
7.1 按 F5
Visual Studio 会编译并运行,弹出窗体。
7.2 操作
- 窗体显示:
温度: [ ] ℃,状态:未连接 - 点 启动轮询 按钮
- 状态变成:
状态:已连接,正在轮询 - 温度框里显示:
25.6 - 每秒刷新一次
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 线程 | 第五天会讲多线程 |
第九部分:你学到了什么
- WinForms 是什么:C# 做 Windows 窗口程序
- 拖控件:Label、TextBox、Button、Timer
- 改控件属性:Text、Name、Interval
- 双击控件写代码:按钮点击、Timer 触发
- 把 Modbus 和界面结合:读数据 → 显示到文本框
- Timer 做轮询:每秒执行一次
第十部分:下一步可以学什么
- 多线程:解决界面卡顿
- 多个数据点:同时显示温度、湿度、压力
- 写数据:加输入框和按钮,把值写回设备
- 报警:超过阈值标红
- Modbus RTU:串口通信