C#winform上位机开发学习笔记3-串口助手的信息保存功能添加-编程知识

1.功能描述

下次开启串口助手时会存留上次的发送框信息，以及选择的串口号（备份串口号与发送栏内容）

原理：将文本信息保存在,ini文件中，下次打开软件时读取文件信息刷新对应控件文本

注意：在窗口关闭事件函数中也可进行信息备份工作，但不稳定，因此用本篇中的方法进行较为可靠

2.代码部分

2.1 创建文件与编辑写入信息存储代码

2.1.1 public partial class Form1 : Form初始化程序中加入以下代码

using System.Runtime.InteropServices;//应用空间变量声明，未声明则出现[DllImport("kernel32")]报错public partial class Form1 : Form{//信息保存功能[DllImport("kernel32")]//写文件函数private static extern long WritePrivateProfileString(string section, string key, string val, string filePath);//系统dll导入ini写函数[DllImport("kernel32")]//读文件函数private static extern int GetPrivateProfileString(string section, string key, string def, StringBuilder retVal, int size, string filePath);//系统dll导入ini读函数//创建文件，文件名为：Backup.inistring FileName = System.AppDomain.CurrentDomain.BaseDirectory + "Backup.ini";}

#存储的文件保存在bin文件中，文件名为创建时编辑的名称“Backup.ini”

2.1.2 串口发送栏函数

备份发送栏

 //串口发送栏函数private void textBox5_TextChanged(object sender, EventArgs e){//备份发送栏WritePrivateProfileString("串口1", "发送栏", textBox5.Text, FileName);//保存文件：其中串口1与发送栏为文本内的标识，将发送栏的信息存储在filename文件中}

2.1.3 手动扫描并添加串口号函数中添加备份串口号程序

备份串口号

 //备份端口号WritePrivateProfileString("串口1", "端口号", comboBox1.Text, FileName);//保存文件：其中串口1与端口号为文本内的标识，将COM组合框的信息存储在filename文件中

手动扫描并添加串口号函数完整代码如下：

        //自定义函数1-手动扫描并添加可用串口private void SearchAndAddSerialToComboBox(SerialPort MyPort, ComboBox MyBox){string[] ComputerPortName = SerialPort.GetPortNames();  //获取本机串口列表//string BackupPort;//定义字符串备份端口号bool MyBackupPortFlag = false;  //备份端口号可用标志位//恢复端口号GetPrivateProfileString("串口1", "端口号", "", BackupBuf, 100, FileName);  //获取备份的端口号string MyBackupPortName = BackupBuf.ToString();//定义字符串备份端口号//添加端口号MyBox.Items.Clear();  //清空ComboBox内容for (int i = 0; i < ComputerPortName.Length; i++) //循环{if (MyBackupPortName == ComputerPortName[i])  //之前的端口号可用,置位标志位{MyBackupPortFlag = true;}try  //核心原理是依靠try和catch完成遍历{MyPort.PortName = ComputerPortName[i];MyPort.Open();                          //如果失败，后面的代码不会执行          MyBox.Items.Add(MyPort.PortName);       //打开成功，添加至下拉列表MyPort.Close();                         //关闭//检测备份端口号是否有效，端口号初始化为备份端口号if (MyBackupPortName == MyPort.PortName){comboBox1.Text = MyBackupPortName;}//如果备份端口号无效，端口号初始化为第一个可用端口号if (comboBox1.Text == " ")comboBox1.Text = MyPort.PortName;}catch{}}//端口号赋初值if (MyBackupPortFlag == true){MyBox.Text = MyBackupPortName; //添加备份的端口号}else{if (ComputerPortName.Length > 0){MyBox.Text = ComputerPortName[ComputerPortName.Length - 1]; //添加数值大的端口号}else{textBox1.AppendText("[" + DateTime.Now.ToString("HH:mm:ss") + "]" + "->");textBox1.AppendText("没有检测到串口工具!\r\n");}}//备份端口号WritePrivateProfileString("串口1", "端口号", comboBox1.Text, FileName);//保存文件：其中串口1与端口号为文本内的标识，将COM组合框的信息存储在filename文件中}

复选框函数中也添加此程序代码

private void comboBox1_SelectedIndexChanged(object sender, EventArgs e){//备份端口号WritePrivateProfileString("串口1", "端口号", comboBox1.Text, FileName);//保存文件：其中串口1与端口号为文本内的标识，将COM组合框的信息存储在filename文件中}

复选框函数万整改代码如下：

        //串口开启状态下切换串口号private void comboBox1_SelectedIndexChanged(object sender, EventArgs e){if (serialPort1.IsOpen) //串口已打开，此时关闭串口 {serialPort1.Close();                       //打开端口try{serialPort1.PortName = comboBox1.Text;    //端口号serialPort1.Open();                       //打开端口textBox1.AppendText("[" + DateTime.Now.ToString("HH:mm:ss") + "]" + "->");textBox1.AppendText("串口更换成功!\r\n");WritePrivateProfileString("串口1", "端口号", comboBox1.Text, FileName);}catch{serialPort1.Close();button2.BackgroundImage = Properties.Resources.Image_CloseSerial;button2.Tag = "OFF";textBox1.AppendText("[" + DateTime.Now.ToString("HH:mm:ss") + "]" + "->");textBox1.AppendText("串口更换失败!\r\n");}}//备份端口号WritePrivateProfileString("串口1", "端口号", comboBox1.Text, FileName);//保存文件：其中串口1与端口号为文本内的标识，将COM组合框的信息存储在filename文件中}

2.2 编写读取文件赋值文本代码

2.2.1 恢复发送栏

2.2.1.1 初始化函数中加入下述代码

    public partial class Form1 : Form{//定义字符串用于存储读出的.ini文件中的内容变量，大小为100个字节StringBuilder BackupBuf = new StringBuilder(100);}

2.2.1.2 窗体装载函数中加入下述代码

        //窗体装载函数private void Form1_Load(object sender, EventArgs e){//恢复发送栏//获取FileName中存储在BackupBuf中内存为100字节的标识为"串口1", "发送栏"的变量，恢复内容若没有则获取空字符GetPrivateProfileString("串口1", "发送栏", "", BackupBuf, 100, FileName);textBox5.Text = BackupBuf.ToString();//获取后将其转换为字符串赋值给发送栏}

2.2.3 恢复时判断存储的端口号是否有效，有效则恢复存储文件的端口号，无效则恢复为首端口号

        //自定义函数1-手动扫描并添加可用串口private void SearchAndAddSerialToComboBox(SerialPort MyPort, ComboBox MyBox){//恢复端口号GetPrivateProfileString("串口1", "端口号", "", BackupBuf, 100, FileName);  //获取备份的端口号string MyBackupPortName = BackupBuf.ToString();//定义字符串备份端口号//检测备份端口号是否有效，端口号初始化为备份端口号if (MyBackupPortName == MyPort.PortName){comboBox1.Text = MyBackupPortName;}//如果备份端口号无效，端口号初始化为第一个可用端口号if (comboBox1.Text == " ")comboBox1.Text = MyPort.PortName;   }

手动扫描并添加串口号函数完整代码如下：

        //自定义函数1-手动扫描并添加可用串口private void SearchAndAddSerialToComboBox(SerialPort MyPort, ComboBox MyBox){string[] ComputerPortName = SerialPort.GetPortNames();  //获取本机串口列表//string BackupPort;//定义字符串备份端口号bool MyBackupPortFlag = false;  //备份端口号可用标志位//恢复端口号GetPrivateProfileString("串口1", "端口号", "", BackupBuf, 100, FileName);  //获取备份的端口号string MyBackupPortName = BackupBuf.ToString();//定义字符串备份端口号//添加端口号MyBox.Items.Clear();  //清空ComboBox内容for (int i = 0; i < ComputerPortName.Length; i++) //循环{if (MyBackupPortName == ComputerPortName[i])  //之前的端口号可用,置位标志位{MyBackupPortFlag = true;}try  //核心原理是依靠try和catch完成遍历{MyPort.PortName = ComputerPortName[i];MyPort.Open();                          //如果失败，后面的代码不会执行          MyBox.Items.Add(MyPort.PortName);       //打开成功，添加至下拉列表MyPort.Close();                         //关闭//检测备份端口号是否有效，端口号初始化为备份端口号if (MyBackupPortName == MyPort.PortName){comboBox1.Text = MyBackupPortName;}//如果备份端口号无效，端口号初始化为第一个可用端口号if (comboBox1.Text == " ")comboBox1.Text = MyPort.PortName;}catch{}}//端口号赋初值if (MyBackupPortFlag == true){MyBox.Text = MyBackupPortName; //添加备份的端口号}else{if (ComputerPortName.Length > 0){MyBox.Text = ComputerPortName[ComputerPortName.Length - 1]; //添加数值大的端口号}else{textBox1.AppendText("[" + DateTime.Now.ToString("HH:mm:ss") + "]" + "->");textBox1.AppendText("没有检测到串口工具!\r\n");}}//备份端口号WritePrivateProfileString("串口1", "端口号", comboBox1.Text, FileName);//保存文件：其中串口1与端口号为文本内的标识，将COM组合框的信息存储在filename文件中}

3.涉及到的相关完整代码

    public partial class Form1 : Form{//信息保存功能[DllImport("kernel32")]//写文件函数private static extern long WritePrivateProfileString(string section, string key, string val, string filePath);//系统dll导入ini写函数[DllImport("kernel32")]//读文件函数private static extern int GetPrivateProfileString(string section, string key, string def, StringBuilder retVal, int size, string filePath);//系统dll导入ini读函数//创建文件，文件名为：Backup.inistring FileName = System.AppDomain.CurrentDomain.BaseDirectory + "Backup.ini";//定义字符串用于存储读出的.ini文件中的内容变量，大小为100个字节StringBuilder BackupBuf = new StringBuilder(100);public Form1(){InitializeComponent();//串口接收支持中文显示serialPort1.Encoding = Encoding.GetEncoding("GB2312");  //串口1的解码支持GB2312汉字System.Windows.Forms.Control.CheckForIllegalCrossThreadCalls = false;//检查跨线程出错解决方法}//窗体装载函数private void Form1_Load(object sender, EventArgs e){SearchAndAddSerialToComboBox(serialPort1, comboBox1);//扫描端口号，并将可用端口添加至下拉列表comboBox14.Text = "115200";                           //默认显示值this.button2.PerformClick();                         //自动打开串口//恢复发送栏//获取FileName中存储在BackupBuf中内存为100字节的标识为"串口1", "发送栏"的变量，恢复内容若没有则获取空字符GetPrivateProfileString("串口1", "发送栏", "", BackupBuf, 100, FileName);textBox5.Text = BackupBuf.ToString();//获取后将其转换为字符串赋值给发送栏}//自定义函数1-手动扫描并添加可用串口private void SearchAndAddSerialToComboBox(SerialPort MyPort, ComboBox MyBox){string[] ComputerPortName = SerialPort.GetPortNames();  //获取本机串口列表//string BackupPort;//定义字符串备份端口号bool MyBackupPortFlag = false;  //备份端口号可用标志位//恢复端口号GetPrivateProfileString("串口1", "端口号", "", BackupBuf, 100, FileName);  //获取备份的端口号string MyBackupPortName = BackupBuf.ToString();//定义字符串备份端口号//添加端口号MyBox.Items.Clear();  //清空ComboBox内容for (int i = 0; i < ComputerPortName.Length; i++) //循环{if (MyBackupPortName == ComputerPortName[i])  //之前的端口号可用,置位标志位{MyBackupPortFlag = true;}try  //核心原理是依靠try和catch完成遍历{MyPort.PortName = ComputerPortName[i];MyPort.Open();                          //如果失败，后面的代码不会执行          MyBox.Items.Add(MyPort.PortName);       //打开成功，添加至下拉列表MyPort.Close();                         //关闭//检测备份端口号是否有效，端口号初始化为备份端口号if (MyBackupPortName == MyPort.PortName){comboBox1.Text = MyBackupPortName;}//如果备份端口号无效，端口号初始化为第一个可用端口号if (comboBox1.Text == " ")comboBox1.Text = MyPort.PortName;}catch{}}//端口号赋初值if (MyBackupPortFlag == true){MyBox.Text = MyBackupPortName; //添加备份的端口号}else{if (ComputerPortName.Length > 0){MyBox.Text = ComputerPortName[ComputerPortName.Length - 1]; //添加数值大的端口号}else{textBox1.AppendText("[" + DateTime.Now.ToString("HH:mm:ss") + "]" + "->");textBox1.AppendText("没有检测到串口工具!\r\n");}}//扫描后写入备份端口号WritePrivateProfileString("串口1", "端口号", comboBox1.Text, FileName);//保存文件：其中串口1与端口号为文本内的标识，将COM组合框的信息存储在filename文件中}//自定义函数2-CRC校验private UInt16 Crc_Check(byte[] Data, byte DataLEN){UInt16 CRC = 0xFFFF;for (byte i = 0; i < DataLEN; i++){ CRC ^= Data[i];for(byte j = 0; j < 8; j++){if((CRC & 0x0001) == 0x0001){CRC = (UInt16)((CRC >> 1) ^ 0xA001);}else{CRC = (UInt16)(CRC >> 1);}}}CRC = (UInt16)((CRC >> 8) + (CRC<<8));return CRC;}//串口开启状态下切换串口号private void comboBox1_SelectedIndexChanged(object sender, EventArgs e){if (serialPort1.IsOpen) //串口已打开，此时关闭串口 {serialPort1.Close();                       //打开端口try{serialPort1.PortName = comboBox1.Text;    //端口号serialPort1.Open();                       //打开端口textBox1.AppendText("[" + DateTime.Now.ToString("HH:mm:ss") + "]" + "->");textBox1.AppendText("串口更换成功!\r\n");WritePrivateProfileString("串口1", "端口号", comboBox1.Text, FileName);}catch{serialPort1.Close();button2.BackgroundImage = Properties.Resources.Image_CloseSerial;button2.Tag = "OFF";textBox1.AppendText("[" + DateTime.Now.ToString("HH:mm:ss") + "]" + "->");textBox1.AppendText("串口更换失败!\r\n");timer1.Stop();}}//复选框选择后备份端口号WritePrivateProfileString("串口1", "端口号", comboBox1.Text, FileName);//保存文件：其中串口1与端口号为文本内的标识，将COM组合框的信息存储在filename文件中}//串口发送栏函数private void textBox5_TextChanged(object sender, EventArgs e){//备份发送栏WritePrivateProfileString("串口1", "发送栏", textBox5.Text, FileName);//保存文件：其中串口1与发送栏为文本内的标识，将发送栏的信息存储在filename文件中}
}