宽容人厚载物

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.ini
        string 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;   
        }