一种比“ini配置文件”和“注册表”更好用的保存“初始化信息”的方法—CArchive类

 

一种比“ini配置文件”和“注册表”更好用的

保存“初始化信息”的方法　　

　　在编写程序时，经常需要将一些初始化信息写入到一个ini配置文件中，当程序启动时从这个配置文件中读取这些初始化信息，当程序关闭时保存当前的设置参数，从而保证用户每次启动程序时的设置都是上一次的设置，方便用户的使用。早期的程序都是将这些初始化信息写入到ini文件中。现在大部分软件都将这些信息写入到注册表中，然后在软件启动时从注册表中读取这些初始化信息。本文介绍一种比以上两种方法更简捷的保存初始化信息的方法——采用CArchive类。用CArchive类来保存初始化信息有简单方便的特点。

 一、ini配置文件对初始化信息的读写

　　(1) 在程序中，如果想向ini配置文件中写入初始化信息，可以使用WritePrivateProfileString()函数来实现。该函数的作用是将一个字符串复制到ini文件的指定段中。WritePrivateProfileString()函数的原型声明为：

　　BOOL WritePrivateProfileString(
　　LPCTSTR lpAppName,
　　LPCTSTR lpKeyName,
　　LPCTSTR lpString,
　　LPCTSTR lpFileName
　　);

　　其中各参数的意义

　　LPCTSTR lpAppName 是INI文件中的一个字段名；
　　LPCTSTR lpKeyName 是lpAppName下的一个键名,通俗讲就是变量名；　
　　LPCTSTR lpString 是键值,也就是变量的值,不过必须为LPCTSTR型或CString型的；
　　LPCTSTR lpFileName 是完整的INI文件名。

 
　　以保存数据波形显示控件Graph的初始化信息为例，介绍WritePrivateProfileString()函数的用法。

　　CString str;
　　str.Format("%f",fScale);
　　::WritePrivateProfileString("fScale","刻度",str,"设置.ini");
　　::WritePrivateProfileString("Y_Current","Y轴当前单位",strYCurrent,"设置.ini");　　

　　代码分析：以上代码实现的功能是保存数据波形显示控件Graph的显示刻度和Y轴当前单位，其中显示刻度为float类型，Y轴当前单位为CString类型。初始化信息保存在"配置.ini"文件中。显示刻度是float类型，需要首先将其转换成CString类型，然后再通过WritePrivateProfileString()写入到"配置.ini"文件中。而Y轴当前单位作为CString类型，可以直接写入到"配置.ini"文件中。

　　(2) ini文件的读取，可以通过Win32 API提供的GetPrivateProfileString()函数来实现。

　　GetPrivateProfileString()函数的原型声明为：
　　DWORD GetPrivateProfileString(
　　LPCTSTR lpAppName, //配置文件的section名
　　LPCTSTR lpKeyName, //配置文件的key名
　　LPCTSTR lpDefault,
　　LPTSTR lpReturnedString,
　　DWORD nSize,
　　LPCTSTR lpFileName
　　);

　　其中各参数的意义:
　　前二个参数与 WritePrivateProfileString中的意义一样.
　　lpDefault : 如果INI文件中没有前两个参数指定的字段名或键名,则将此值赋给变量.
　　lpReturnedString : 接收INI文件中的值的CString对象,即目的缓存器.
　　nSize : 目的缓存器的大小.
　　lpFileName : 是完整的INI文件名.

 

　　以读取数据波形显示控件Graph的初始化信息为例，介绍GetPrivateProfileString()函数的用法。　

　　  CString str;
　　::GetPrivateProfileString("fScale","刻度","1",str.GetBuffer(64),64,"设置.ini");
 　　fScale=float(atof(str));
　　::GetPrivateProfileString("Y_Current","Y轴当前单位","",strYCurrent.GetBuffer(64),64,"设置.ini");

　　代码分析：以上代码实现的功能是读取数据波形显示控件Graph的显示刻度和Y轴当前单位，其中显示刻度为float类型，Y轴当前单位为CString类型。初始化信息保存在"配置.ini"文件中。显示刻度是float类型，通过GetPrivateProfileString()读取到的为CString类型，需要通过atof()函数将其转换成float类型。而Y轴当前单位作为CString类型，不必进行转换。

二、注册表对初始化信息的读写

　　注册表方式是目前采用较多的保存初始化信息的方法。写入注册表可以通过RegCreateKey()和RegSetValue()函数来实现，读取注册表信息可以通过两次调用RegQueryValue()函数来实现。 关于RegCreateKey()、RegSetValue()及RegQueryValue()函数的原型声明可查看MSDN文件，下面举例介绍读取和写入注册表的方法。

　　(1) 往注册表写入信息　　

 　　HKEY hKey;
 　　DWORD dwAge=30;
 　　RegCreateKey(HKEY_LOCAL_MACHINE,"Software\\Yunit",&hKey);
 　　RegSetValue(hKey,NULL,REG_SZ,"mV",strlen("mV"));
 　　RegSetValueEx(hKey,"age",0,REG_DWORD,(CONST BYTE*)&dwAge,4);
 　　RegCloseKey(hKey); 

　　以上代码实现了往注册表中写入dwAge和字符串“mV”的方法。

　　(2) 读取注册表信息

　　HKEY hKey;
 　　RegOpenKey(HKEY_LOCAL_MACHINE,"Software\\Yunit",&hKey);
　　 DWORD dwType;
 　　DWORD dwValue;
　　 DWORD dwAge;
 　　RegQueryValueEx(hKey,"age",0,&dwType,(LPBYTE)&dwAge,&dwValue);
　　 CString str;
 　　str.Format("age=%d",dwAge);
 　　MessageBox(str);　

　　以上代码从注册表中读取了dwAge并通过MessageBox()函数显示出来。

三、使用CArchive类来保存初始化信息

　　一个CArchive类是一种二进制流，且与一个文件相关，允许带缓冲机制的数据写入和读取。CArchive类能以一种有效、非冗余的格式处理二进制对象数据。在程序中使用CArchive对象时必须注意：1、在创建CArchive对象之前必须先创建一个CFile类或其派生类对象；2、必须确保这个CFile类对象的打开方式与该存档(archive)对象的加载/保存状态一致；3、一个文件只能与一个活动的存档对象相关联。

　　CArchive对象不仅可以处理基本类型的数据，还可以处理CObject类的派生类对象。CArchive类重载了提取(>>)和插入(<<)操作符，它们既支持基本类型，也支持CObject类的派生类，为用户提供了一种方便的对象存档编程接口。通过这些重载的函数，我们可以利用CArchive对象来保存和读取程序的初始化信息。

　　CArchive类的构造函数的原型声明如下：
　　CArchive(CFile* pFile, UNIT nMode, int nBufSize=4096, void* lpBuf=NULL)；
　　参数pFile：指向文件对象的指针，该文件对象是持久数据的最终来源或目的地；
　　参数nMode：指定对象是用来被加载的，还是用来保存的标志；
　　参数nBufSize：指定内部文件缓冲区的大小，以字节为单位。默认的缓冲区大小是4096字节；
　　参数lpBuf：可选指针，指向用户提供的大小为nBufSize的缓冲区。如果未指定这个参数，则存档对象将从应用程序的局部堆中分配一块缓冲区，并且该对象销毁时将释放这块内存。　　下面以数据波形显示控件Graph的初始化信息的保存和读取为例，来说明CArchive类的用法。

　　(1) 初始化信息的保存

　　CFile file(“Setting.txt”,CFile::modeWrite|CFile::modeCreate);
　　 CArchive ar(&file,CArchive::store);
　　ar<<bShowRange<<fScale<<fTrack<<bShowMode<<strXCurrent
　　　<<fXk<<strYCurrent<<fYk<<bLineWidth<<nLineColor<<fWheelScale;

　　以上三行代码的功能是将数据波形显示控件Graph的显示范围、显示刻度、跟踪阈值、X轴当前单位、X轴单位转换系数、Y轴当前单位、Y轴单位转换系数、线宽、线条颜色、滚轮刻度信息保存在文件Setting.txt中。第一行代码中的|CFile::modeCreate指当文件Setting.txt不存在时，则先创建它。

　　(2) 初始化信息的读取

　　CFile file(“Setting.txt”,CFile::modeRead);
　　 CArchive ar(&file,CArchive::load);
 　　ar>>bShowRange>>fScale>>fTrack>>bShowMode>>strXCurrent
　　    >>fXk>>strYCurrent>>fYk>>bLineWidth>>nLineColor>>fWheelScale;　　以上三行代码实现的功能是从文件“Setting.txt”中依次读取出数据波形显示控件Graph的显示范围、显示刻度、跟踪阈值、X轴当前单位、X轴单位转换系数、Y轴当前单位、Y轴单位转换系数、线宽、线条颜色、滚轮刻度信息。

四、三种方式的对比

　　从第三节可以看出，使用CArchive类保存和读取数据波形显示控件Graph的显示范围、显示刻度、跟踪阈值、X轴当前单位、X轴单位转换系数、Y轴当前单位、Y轴单位转换系数、线宽、线条颜色、滚轮刻度信息只用了三行代码。若使用ini配置文件，则读取初始化信息的代码如下：

　　CString str;
　　 ::GetPrivateProfileString("bShowRange","显示方式","1",str.GetBuffer(64),64,"设置.ini");
　　 bShowRange=BOOL(atoi(str));
　　 ::GetPrivateProfileString("fTrack","跟踪阈值","1",str.GetBuffer(64),64,"设置.ini");
　　 fTrack=float(atof(str));
　　 ::GetPrivateProfileString("fScale","刻度","1",str.GetBuffer(64),64,"设置.ini");
 　　fScale=float(atof(str));
　　 ::GetPrivateProfileString("bShowMode","显示模式","0",str.GetBuffer(64),64,"设置.ini");
 　　bShowMode=BOOL(atoi(str));
 　　nLineColor=::GetPrivateProfileInt("nLineColor","曲线颜色",2,"设置.ini");

 　　::GetPrivateProfileString("X_Origin","X轴原单位","",strXOrigin.GetBuffer(64),64,"设置.ini");
　　 ::GetPrivateProfileString("Y_Origin","Y轴原单位","",strYOrigin.GetBuffer(64),64,"设置.ini");
 　　::GetPrivateProfileString("X_Current","X轴当前单位","",strXCurrent.GetBuffer(64),64,"设置.ini");
　　 ::GetPrivateProfileString("Y_Current","Y轴当前单位","",strYCurrent.GetBuffer(64),64,"设置.ini");
 　　::GetPrivateProfileString("Convert_XK","X轴转换系数","1",str.GetBuffer(64),64,"设置.ini");
 　　fXk=float(atof(str));
 　　::GetPrivateProfileString("Convert_YK","Y轴转换系数","1",str.GetBuffer(64),64,"设置.ini");
　　 fYk=float(atof(str));

　　代码数量比采用CArchive类多了很多。采用注册表方法的代码量与采用ini配置文件的差不多。可以看出CArchive类保存初始化信息的优势，尤其是当初始化信息量很多的时候，这种优势更为明显。