MFC读写ini文件方法

在我们的程序设计中经常需要对一些参数进行配置，配置好后还要在下一次启动仍然有效，那么一个有效的可行办法就是使用ini文件，也就是Windows初始化文件来保存一些我们的设置，然后让程序启动的时候从这个ini文件中读取相关配置。我们需要做以下的工作。

      1.创建此ini文件，Windows对ini文件的操作有专门的函数，我们经常用的就是WritePrivateProfileString()和GetPrivateProfileString()了。那么我们在程序的初始化时首先检查是否存在ini文件，如果不存在则创建一个默认的ini文件。

          我们使用CFileFind类查找我们需要的ini文件是否存在，若不存在则创建一个。WritePrivateProfileString()当ini不存在时会自动创建一个ini文件在指定路径。

　　在我们写的程序当中,总有一些配置信息需要保存下来,以便完成程序的功能,最简单的办法就是将这些信息写入INI文件中,程序初始化时再读入.具体应用如下:
　　一.将信息写入.INI文件中.
　　1.所用的WINAPI函数原型为: 
BOOL WritePrivateProfileString(
LPCTSTR lpAppName,
LPCTSTR lpKeyName,
LPCTSTR lpString,
LPCTSTR lpFileName
);　　其中各参数的意义:
　　　LPCTSTR lpAppName 是INI文件中的一个字段名.
　　　LPCTSTR lpKeyName 是lpAppName下的一个键名,通俗讲就是变量名.
　　　LPCTSTR lpString 是键值,也就是变量的值,不过必须为LPCTSTR型或CString型的.
　　　LPCTSTR lpFileName 是完整的INI文件名.
　　2.具体使用方法:设现有一名学生,需把他的姓名和年龄写入 c:\stud\student.ini 文件中. 
CString strName,strTemp;
int nAge;
strName="张三";
nAge=12;
::WritePrivateProfileString("StudentInfo","Name",strName,"c:\\stud\\student.ini");　　此时c:\stud\student.ini文件中的内容如下:
　　　[StudentInfo]
　　　Name=张三
　　3.要将学生的年龄保存下来,只需将整型的值变为字符型即可:
strTemp.Format("%d",nAge);
::WritePrivateProfileString("StudentInfo","Age",strTemp,"c:\\stud\\student.ini");　

二.将信息从INI文件中读入程序中的变量.
　　1.所用的WINAPI函数原型为:
DWORD GetPrivateProfileString(
LPCTSTR lpAppName, 
LPCTSTR lpKeyName, 
LPCTSTR lpDefault, 
LPTSTR lpReturnedString, 
DWORD nSize, 
LPCTSTR lpFileName 
);　　其中各参数的意义: 
　　　前二个参数与 WritePrivateProfileString中的意义一样.
　　　lpDefault : 如果INI文件中没有前两个参数指定的字段名或键名,则将此值赋给变量. 
　　　lpReturnedString : 接收INI文件中的值的CString对象,即目的缓存器.
　　　nSize : 目的缓存器的大小.
　　　lpFileName : 是完整的INI文件名.
　　2.具体使用方法:现要将上一步中写入的学生的信息读入程序中.
CString strStudName;
int nStudAge; 
GetPrivateProfileString("StudentInfo","Name","默认姓名",strStudName.GetBuffer(MAX_PATH),MAX_PATH,"c:\\stud\\student.ini");　　执行后 strStudName 的值为:"张三",若前两个参数有误,其值为:"默认姓名".
　　3.读入整型值要用另一个WINAPI函数: 
UINT GetPrivateProfileInt(
LPCTSTR lpAppName, 
LPCTSTR lpKeyName, 
INT nDefault, 
LPCTSTR lpFileName 
);　　这里的参数意义与上相同.使用方法如下:
nStudAge=GetPrivateProfileInt("StudentInfo","Age",10,"c:\\stud\\student.ini");
　三.循环写入多个值,设现有一程序,要将最近使用的几个文件名保存下来,具体程序如下:
　　1.写入:

CString strTemp,strTempA;
int i;
int nCount=6;
file://共有6个文件名需要保存
for(i=0;i {strTemp.Format("%d",i);
strTempA=文件名;
file://文件名可以从数组,列表框等处取得.
::WritePrivateProfileString("UseFileName","FileName"+strTemp,strTempA,
"c:\\usefile\\usefile.ini");
}
strTemp.Format("%d",nCount);
::WritePrivateProfileString("FileCount","Count",strTemp,"c:\\usefile\\usefile.ini");
file://将文件总数写入,以便读出.
　　2.读出:
nCount=::GetPrivateProfileInt("FileCount","Count",0,"c:\\usefile\\usefile.ini");
for(i=0;i {strTemp.Format("%d",i);
strTemp="FileName"+strTemp;
::GetPrivateProfileString("CurrentIni",strTemp,"default.fil", strTempA.GetBuffer(MAX_PATH),MAX_PATH,"c:\\usefile\\usefile.ini");

file://使用strTempA中的内容.

}　　补充四点:
　　　1.INI文件的路径必须完整,文件名前面的各级目录必须存在,否则写入不成功,该函数返回 FALSE 值.
　　　2.文件名的路径中必须为 \\ ,因为在VC++中, \\ 才表示一个 \ .
　　　3.也可将INI文件放在程序所在目录,此时 lpFileName 参数为: ".\\student.ini".
　　　4.从网页中粘贴源代码时,最好先粘贴至记事本中,再往VC中粘贴,否则易造成编译错误,开始时我也十分不解,好好的代码怎么就不对呢?后来才找到这个方法.还有一些代码中使用了全角字符如:＜，＼等,也会
造成编译错误.

============

 

VC中用函数读写ini文件的方法

         ini文件(即Initialization file)，这种类型的文件中通常存放的是一个程序的初始化信息。ini文件由若干个节(Section)组成，每个Section由若干键(Key)组成，每个Key可以赋相应的值。读写ini文件实际上就是读写某个的Section中相应的Key的值，而这只要借助几个函数即可完成。


一、向ini文件中写入信息的函数
1. 把信息写入系统的win.ini文件
BOOL WriteProfileString(
      LPCTSTR lpAppName, // 节的名字，是一个以0结束的字符串
      LPCTSTR lpKeyName, // 键的名字，是一个以0结束的字符串。若为NULL，则删除整个节
      LPCTSTR lpString       // 键的值，是一个以0结束的字符串。若为NULL，则删除对应的键
)


2. 把信息写入自己定义的.ini文件
BOOL WritePrivateProfileString(
      LPCTSTR lpAppName,      // 同上
      LPCTSTR lpKeyName,      // 同上
      LPCTSTR lpString,       // 同上
      LPCTSTR lpFileName      // 要写入的文件的文件名。若该ini文件与程序在同一个目录下，也可使用相对
            //路径,否则需要给出绝度路径。
)

如：
::WriteProfileString("Test","id","xym"); 
//在win.ini中创建一个Test节，并在该节中创建一个键id,其值为xym

::WritePrivateProfileString("Test","id","xym","d://vc//Ex1//ex1.ini");
//在Ex1目录下的ex1.ini中创建一个Test节，并在该节中创建一个键id,其值为xym

//若Ex1.ini文件与读写该文件的程序在同一个目录下，则上面语句也可写为：
::WritePrivateProfileString("Test","id","xym",".//ex1.ini");

需要注意的是，C系列的语言中，转义字符'//'表示反斜线'/'。另外，当使用相对路径时，//前的.号不能丢掉了。

二、从ini文件中读取数据的函数
1、从系统的win.ini文件中读取信息
(1) 读取字符串
DWORD GetProfileString(
      LPCTSTR lpAppName,            // 节名
      LPCTSTR lpKeyName,            // 键名，读取该键的值
      LPCTSTR lpDefault,            // 若指定的键不存在，该值作为读取的默认值
      LPTSTR lpReturnedString,      // 一个指向缓冲区的指针，接收读取的字符串
      DWORD nSize                   // 指定lpReturnedString指向的缓冲区的大小
)

如：
CString str;
::GetProfileString("Test","id","Error",str.GetBuffer(20),20);

(2) 读取整数
UINT GetProfileInt(
      LPCTSTR lpAppName,      // 同上
      LPCTSTR lpKeyName,      // 同上
      INT nDefault            // 若指定的键名不存在，该值作为读取的默认值
)

如使用以下语句写入了年龄信息：
::WriteProfileString("Test","age","25"); 
//在win.ini中创建一个Test节，并在该节中创建一个键age,其值为25

则可用以下语句读取age键的值：
int age;
age=::GetProfileInt("Test","age",0);

2、从自己的ini文件中读取信息
(1) 读取字符串
DWORD GetPrivateProfileString(
      LPCTSTR lpAppName,            // 同1(1)
      LPCTSTR lpKeyName,            // 同1(1)
      LPCTSTR lpDefault,            // 同1(1)
      LPTSTR lpReturnedString,      // 同1(1)
      DWORD nSize,                  // 同1(1)
      LPCTSTR lpFileName            // 读取信息的文件名。若该ini文件与程序在同一个目录下，也可使用相      
            //对路径,否则需要给出绝度路径。
)

如：
CString str;
::GetPrivateProfileString("Test","id","Error",str.GetBuffer(20),20，".//ex1.ini");
或：
::GetPrivateProfileString("Test","id","Error",str.GetBuffer(20),20，"d://vc//Ex1//ex1.ini");

(2) 读取整数

UINT GetPrivateProfileInt(
      LPCTSTR lpAppName,      // 同上
      LPCTSTR lpKeyName,      // 同上
      INT nDefault,           // 若指定的键名不存在，该值作为读取的默认值
      LPCTSTR lpFileName      // 同上
)

如使用以下语句写入了年龄信息：
::WritePrivateProfileString("Test","age","25",".//ex1.ini"); 
//在ex1.ini中创建一个Test节，并在该节中创建一个键age,其值为25

则可用以下语句读取age键的值：
int age;
age=::GetPrivateProfileInt("Test","age",0,".//ex1.ini");

三、 删除键值或节

       回顾一下WriteProfileString函数的说明
BOOL WriteProfileString(
      LPCTSTR lpAppName, // 节的名字，是一个以0结束的字符串
      LPCTSTR lpKeyName, // 键的名字，是一个以0结束的字符串。若为NULL，则删除整个节
      LPCTSTR lpString       // 键的值，是一个以0结束的字符串。若为NULL，则删除对应的键
)

       由此可见，要删除某个节，只需要将WriteProfileString第二个参数设为NULL即可。而要删除某个键，则只需要将该函数的第三个参数设为 NULL即可。这是删除系统的win.ini中的节或键，类似的，要删除自己定义的ini文件中的节或键，也可做相同的操作。
       如：
::WriteProfileString("Test",NULL,NULL);      //删除win.ini中的Test节
::WriteProfileString("Test","id",NULL);      //删除win.ini中的id键

::WritePrivateProfileString("Test",NULL,NULL,".//ex1.ini");      //删除ex1.ini中的Test节
::WritePrivateProfileString("Test","id",NULL,".//ex1.ini");      //删除ex1.ini中的id键

四、如何判断一个ini文件中有多少个节
       要判断一个ini文件中有多少个节，最简单的办法就是将所有的节名都找出来，然后统计节名的个数。而要将所有的节名找出来，使用GetPrivateProfileSectionNames函数就可以了，其原型如下：
DWORD GetPrivateProfileSectionNames(
      LPTSTR lpszReturnBuffer,      // 指向一个缓冲区，用来保存返回的所有节名
      DWORD nSize,                  // 参数lpszReturnBuffer的大小
      LPCTSTR lpFileName            // 文件名，若该ini文件与程序在同一个目录下，

                                                //也可使用相对路径,否则需要给出绝度路径
)

下面的是用来统计一个ini文件中共有多少个节的函数，当然，如果需要同时找到每个节中的各个键及其值，根据找到节名就可以很容易的得到了。


/*统计共有多少个节
节名的分离方法：若chSectionNames数组的第一字符是'/0'字符，则表明
有0个节。否则，从chSectionNames数组的第一个字符开始，顺序往后找，
直到找到一个'/0'字符，若该字符的后继字符不是 '/0'字符，则表明前
面的字符组成一个节名。若连续找到两个'/0'字符，则统计结束*/


int CTestDlg::CalcCount(void)
{
TCHAR       chSectionNames[2048]={0};       //所有节名组成的字符数组
char * pSectionName; //保存找到的某个节名字符串的首地址
int i;       //i指向数组chSectionNames的某个位置，从0开始，顺序后移
int j=0;      //j用来保存下一个节名字符串的首地址相对于当前i的位置偏移量
int count=0;      //统计节的个数

//CString name;
//char id[20];
::GetPrivateProfileSectionNames(chSectionNames,2048,".//ex1.ini");   
for(i=0;i<2048;i++,j++)
{
      if(chSectionNames[0]=='/0')
       break;       //如果第一个字符就是0，则说明ini中一个节也没有
      if(chSectionNames[i]=='/0')
      {
       pSectionName=&chSectionNames[i-j]; //找到一个0，则说明从这个字符往前，减掉j个偏移量，
            //就是一个节名的首地址

       j=-1;         //找到一个节名后，j的值要还原，以统计下一个节名地址的偏移量
            //赋成-1是因为节名字符串的最后一个字符0是终止符，不能作为节名

            //的一部分
       /*::GetPrivateProfileString(pSectionName,"id","Error",id,20,".//ex1.ini");
       name.Format("%s",id);*/   
       //在获取节名的时候可以获取该节中键的值，前提是我们知道该节中有哪些键。
   
       AfxMessageBox(pSectionName);      //把找到的显示出来

       if(chSectionNames[i+1]==0)
       {
         break;      //当两个相邻的字符都是0时，则所有的节名都已找到，循环终止
       }
      }   
}
return count;
}

 

//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

/////////////////////////////////////////////////////////////////

在VC程序中利用系统提供的GetPrivateProfileString及WritePrivateProfileString函数直接读写系统配置ini文件(指定目录下的Ini文件)

假设在当前目录下有一个文件名为Tets.ini的文件
用于保存用户名和密码
文件格式如下：
[Section1]
Item1=huzhifeng
Item2=1234565

1.写INI文件
void CINI_File_TestDlg::OnButtonWrite() 
{
 // TODO: Add your control notification handler code here

 CString strSection       = "Section1";
  CString strSectionKey    = "Item1";
 char strBuff[256];
  CString strValue       = _T("");
 CString strFilePath;

 strFilePath=GetCurrentDirectory(256,strBuff);  //获取当前路径
 strFilePath.Format("%s//Test.ini",strBuff);

 GetDlgItemText(IDC_EDIT_NAME,strValue);     //获取文本框内容：即姓名
 WritePrivateProfileString(strSection,strSectionKey,strValue,strFilePath);  //写入ini文件中相应字段

 strSectionKey="Item2";
 GetDlgItemText(IDC_EDIT_PASSWORD,strValue);   //获取文本框内容：即密码
 WritePrivateProfileString(strSection,strSectionKey,strValue,strFilePath);
}

2.读INI文件内容
void CINI_File_TestDlg::OnButtonRead() 
{
 // TODO: Add your control notification handler code here
 CString strSection       = "Section1";
  CString strSectionKey    = "Item1";
 char strBuff[256];
 CString strValue       = _T("");
 CString strFilePath;

 strFilePath=GetCurrentDirectory(256,strBuff);  //获取当前路径
 strFilePath.Format("%s//Test.ini",strBuff);

 GetPrivateProfileString(strSection,strSectionKey,NULL,strBuff,80,strFilePath); //读取ini文件中相应字段的内容
 strValue=strBuff;
 SetDlgItemText(IDC_EDIT_NAME,strValue);

 strSectionKey="Item2";
 GetPrivateProfileString(strSection,strSectionKey,NULL,strBuff,80,strFilePath);
 strValue=strBuff;
 SetDlgItemText(IDC_EDIT_PASSWORD,strValue);

 UpdateData(FALSE);
}