Delphi中初始化.Ini文件的读写 金林樵 郭彩虹 在Windows中的应用程序极大多数拥有自己的初始化文件,如PowerBuilder、Office及Cstar等。因此初始化文件的读写是每个高级程序员必须掌握的技术。虽然初始化文件的读写也可用Object Pascal中的文本文件一样读写,但因初始化文件不同于一般的文本文件,它有自己固定的格式(见下面的初始化文件是ucdos中提供的rdfnt.ini文件),如果用文本文件的方式读写,不仅格式转换十分繁琐,且很容易出现错误,为了方便程序员读写初始化文件中的数据,Delphi中向用户提供了一个TIniFile类,通过TiniFile类就可十分方便地读写初始化文件。Ucdos中rdfnt.ini文件的内容为:[True Type fonts directory]Dir=C:\WINDOWS\SYSTEM [True Type fonts list]ARIAL.TTF=64ARIALBD.TTF=65ARIALI.TTF=66ARIALBI.TTF=67TIMES.TTF=68TIMESBD.TTF=69TIMESI.TTF=70TIMESBI.TTF=71COUR.TTF=72COURBD.TTF=73COURI.TTF=74COURBI.TTF=75 [Use All True Type fonts]All=0 TiniFile类不是一个Delphi的部件,因此不能在Delphi的VCL模板中找到,它在Delphi 系统中的inifiles单元中定义,因此要使用TiniFile类,必须在使用该类的单元文件中用Uses inifiles指令明确地说明。TiniFile类中定义了许多成员函数,这里介绍几个使用频率较高的成员函数: ⑴ Create() 函数定义为: constructor Create(const FileName: string);该函数建立TiniFile类的对象。参数FileName是要读写的初始化文件名。若读写的文件在Windows的目录里(如system.ini文件),则可以直接写文件名而不必指定路径,否则就必须指定路径(如d:\ucdos\rdfnt.ini)。如按以下规则在规定的目录中存在该文件,则打开该初始化文件;否则在规定的目录里创建该初始化文件。 ⑵ ReadSections() 过程定义为: procedure ReadSections(Strings: TStrings);该过程将从所建立的TiniFile类的对象(即与之关联的初始化文件)中读取所有的节点名(即用[]括号括起的那部分,如rdfnt.ini文件中的[True Type fonts list])存入字符串列表中。参数Strings即为字符串列表的变量名。 ⑶ ReadSectionValues() 过程定义为: procedure ReadSectionValues(const Section: string; Strings: TStrings); 该过程将参数Section的值所对应的节点(如rdfnt.ini文件中的[True Type fonts list])中的各个关键字(如ARIALBI.TTF)及其所含的值(如ARIALBI.TTF关键字值为67)读入参数Strings指明的字符串列表中。 ⑷ ReadSection()过程定义为: procedure ReadSection(const Section: string; Strings: TStrings);该过程将参数Section的值所对应的节点中的各个关键字读入参数Strings指明的字符串列表中。与ReadSectionValues()不同的是它没有读取各个关键字的对应值。 ⑸ ReadString() 函数定义为: function ReadString(const Section, Ident, Default: string): string;该函数返回以参数Section的值为节点名、参数Ident的值为关键字名所对应的关键字值(如[True Type fonts list]节中ARIALBI.TTF关键字的值为67)。当指定的节点或节内的关键字不存在时,则函数返回参数Default的缺省值。返回的值是一个字符串型数据。当指定节点中关键字值的数据类型不是字符串时,则可用ReadInteger()成员函数读取一个整型值,用ReadBool()成员函数读取一个布尔值。 ⑹ WriteString()过程定义为: procedure WriteString(const Section, Ident, Value: string);该过程将参数Section的值为节点名、参数Ident的值为关键字名的关键字值设置为参数Value的值。该过程设置的是字符串型数据。当指定节点和关键字均存在时,则用Value的值替代原值;如指定节点不存在,则在关联的初始化文件中自动增加一个节点,该节点的值为参数Section的值,并在该节点下自动增加一个关键字,关键字名为参数Ident的值,该关键字对应的值为参数Value的值;若节点存在,但关键字不存在,则在该节点下自动增加一个关键字,关键字名为参数Ident的值,该关键字对应的值为参数Value的值。若要设置整型值,可调用WriteInteger()成员函数;用WriteBool()成员函数设置布尔值。知道了以上函数的作用,要建立或读写一个初始化文件就不难了。下面以一个实际例子说明初始化文件的读取方法,步骤如下:
⒈ 在需要读写初始化文件的窗体(Form)上放置名为SectionComboBox、IdentComboBox的两个组合式列表框,其中SectionComboBox存放节点名,IdentComboBox存放所选择节点的关键字名。一个名为IdentValueEdit的输入框,存放对应关键字的值。名为CmdChang的修改命令钮可以用来修改关键字的值,修改后用名为CmdSave的存储命令钮将修改后的关键字的值存入关联的初始化文件。窗体对应的单元名设为IniUnit,窗体名设为IniForm,窗体布局如下图一所示: ⒉ 在IniUnit单元的interface部分用uses inifiles;说明要引用的TiniFile类所定义的单元名。并在变量说明部分定义TiniFile类的对象,如var IniFile: TiniFile;⒊ 建立窗体的OnCreate事件过程。使用TIniFile类的Create成员函数创建TIniFile对象,用该对象读写d:\ucdos目录中的rdfnt.ini初始化文件,并将该初始化文件中的所有节点通过ReadSections() 成员函数读入SectionComboBox组合式列表框中,用ReadSection()成员函数将第一个节点中的所有关键字读入IdentComboBox 组合式列表框,用ReadString()成员函数将第一个关键字的值送入IdentValueEdit输入框。⒋ 建立SectionComboBox组合式列表框的OnChange事件过程。当该选择列表框中的不同项目(即不同的节点名)时,用ReadSection()成员函数将选节点中的所有关键字读入IdentComboBox 组合式列表框,并用ReadString()成员函数将第一个关键字的值送入IdentValueEdit输入框。⒌ 建立IdentComboBox组合式列表框的OnChange事件过程。当该选择列表框中的不同项目(即不同的关键字名)时,用ReadString()成员函数将该关键字的值送入IdentValueEdit输入框。⒍ 建立命令钮CmdChang的OnClick事件过程。使IdentValueEdit输入框中的内容可以修改(不按该命令钮,IdentValueEdit输入框是不能修改的),并设置命令钮CmdSave有效,可以将修改后的关键字值存入关联的初始化文件中。 ⒎ 建立命令钮CmdSave的OnClick事件过程。如果关键字值已改变,则调用WriteString()成员函数将修改后的关键字的值存盘。⒏ 建立窗体的OnDestroy事件过程。当窗体失效时,将建立的TIniFile对象释放,以释放该对象所战用的系统资源。至此,运行该工程,初始化文件的读写已能顺利进行。当然还可以使用EraseSection()成员函数删除指定的节,也可用DeleteKey()成员函数删除指定的关键字,因篇幅有限,这里就不详细介绍了,有兴趣的可参考Delphi的使用帮助。下面是该单元的源程序代码:unit IniUnit; interface uses Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs, StdCtrls, inifiles; type TIniForm = class(TForm) SectionComboBox: TComboBox; Label1: TLabel; CmdSave: TButton; CmdChang: TButton; IdentComboBox: TComboBox; IdentValueEdit: TEdit; Label2: TLabel; Label3: TLabel; procedure FormCreate(Sender: TObject); procedure SectionComboBoxChange(Sender: TObject); procedure FormDestroy(Sender: TObject); procedure CmdChangClick(Sender: TObject); procedure CmdSaveClick(Sender: TObject); procedure IdentComboBoxChange(Sender: TObject); private { Private declarations } public { Public declarations } end; var IniForm: TIniForm;{ Delphi中通过TIniFile类读写Windows的初始化文件 } IniFile: TIniFile; implementation {$R *.DFM} procedure TIniForm.FormCreate(Sender: TObject);begin{ 使用TIniFile类的Create成员函数建立TIniFile对象,该对象用来读写d:\ucdos目录中的rdfnt.ini文件,如果读写的文件在Windows的目录里(如system.ini),则可以直接写文件名而不必指定路径 } IniFile:=TIniFile.Create('d:\ucdos\rdfnt.ini');{ 将TIniFile对象关联的初始化文件system.ini中的所有节(即用[]括号括起的那部分)的节名送入下拉式组合列表框SectionComboBox中 } SectionComboBox.Clear; IniFile.ReadSections(SectionComboBox.Items);{ 选择system.ini文件的第一个节名 } SectionComboBox.ItemIndex:=0; SectionComboBoxChange(Sender); CmdSave.Enabled:=False;end; { 将组合列表框IniComboBox中所选择节中对应的各个变量及对应的值送入多行文本编辑器IniMemo中 }procedure TIniForm.SectionComboBoxChange(Sender: TObject);begin IdentComboBox.Clear; IniFile.ReadSection(SectionComboBox.Text, IdentComboBox.Items); IdentComboBox.ItemIndex:=0; IdentComboBoxChange(Sender);end; procedure TIniForm.IdentComboBoxChange(Sender: TObject);begin IdentValueEdit.Enabled:=False; { 将选择的关键字值读入 } IdentValueEdit.Text:= IniFile.ReadString(SectionComboBox.Text, IdentComboBox.Text,'');end;
⒈ 在需要读写初始化文件的窗体(Form)上放置名为SectionComboBox、IdentComboBox的两个组合式列表框,其中SectionComboBox存放节点名,IdentComboBox存放所选择节点的关键字名。一个名为IdentValueEdit的输入框,存放对应关键字的值。名为CmdChang的修改命令钮可以用来修改关键字的值,修改后用名为CmdSave的存储命令钮将修改后的关键字的值存入关联的初始化文件。窗体对应的单元名设为IniUnit,窗体名设为IniForm,窗体布局如下图一所示: ⒉ 在IniUnit单元的interface部分用uses inifiles;说明要引用的TiniFile类所定义的单元名。并在变量说明部分定义TiniFile类的对象,如var IniFile: TiniFile;⒊ 建立窗体的OnCreate事件过程。使用TIniFile类的Create成员函数创建TIniFile对象,用该对象读写d:\ucdos目录中的rdfnt.ini初始化文件,并将该初始化文件中的所有节点通过ReadSections() 成员函数读入SectionComboBox组合式列表框中,用ReadSection()成员函数将第一个节点中的所有关键字读入IdentComboBox 组合式列表框,用ReadString()成员函数将第一个关键字的值送入IdentValueEdit输入框。⒋ 建立SectionComboBox组合式列表框的OnChange事件过程。当该选择列表框中的不同项目(即不同的节点名)时,用ReadSection()成员函数将选节点中的所有关键字读入IdentComboBox 组合式列表框,并用ReadString()成员函数将第一个关键字的值送入IdentValueEdit输入框。⒌ 建立IdentComboBox组合式列表框的OnChange事件过程。当该选择列表框中的不同项目(即不同的关键字名)时,用ReadString()成员函数将该关键字的值送入IdentValueEdit输入框。⒍ 建立命令钮CmdChang的OnClick事件过程。使IdentValueEdit输入框中的内容可以修改(不按该命令钮,IdentValueEdit输入框是不能修改的),并设置命令钮CmdSave有效,可以将修改后的关键字值存入关联的初始化文件中。 ⒎ 建立命令钮CmdSave的OnClick事件过程。如果关键字值已改变,则调用WriteString()成员函数将修改后的关键字的值存盘。⒏ 建立窗体的OnDestroy事件过程。当窗体失效时,将建立的TIniFile对象释放,以释放该对象所战用的系统资源。至此,运行该工程,初始化文件的读写已能顺利进行。当然还可以使用EraseSection()成员函数删除指定的节,也可用DeleteKey()成员函数删除指定的关键字,因篇幅有限,这里就不详细介绍了,有兴趣的可参考Delphi的使用帮助。下面是该单元的源程序代码:unit IniUnit; interface uses Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs, StdCtrls, inifiles; type TIniForm = class(TForm) SectionComboBox: TComboBox; Label1: TLabel; CmdSave: TButton; CmdChang: TButton; IdentComboBox: TComboBox; IdentValueEdit: TEdit; Label2: TLabel; Label3: TLabel; procedure FormCreate(Sender: TObject); procedure SectionComboBoxChange(Sender: TObject); procedure FormDestroy(Sender: TObject); procedure CmdChangClick(Sender: TObject); procedure CmdSaveClick(Sender: TObject); procedure IdentComboBoxChange(Sender: TObject); private { Private declarations } public { Public declarations } end; var IniForm: TIniForm;{ Delphi中通过TIniFile类读写Windows的初始化文件 } IniFile: TIniFile; implementation {$R *.DFM} procedure TIniForm.FormCreate(Sender: TObject);begin{ 使用TIniFile类的Create成员函数建立TIniFile对象,该对象用来读写d:\ucdos目录中的rdfnt.ini文件,如果读写的文件在Windows的目录里(如system.ini),则可以直接写文件名而不必指定路径 } IniFile:=TIniFile.Create('d:\ucdos\rdfnt.ini');{ 将TIniFile对象关联的初始化文件system.ini中的所有节(即用[]括号括起的那部分)的节名送入下拉式组合列表框SectionComboBox中 } SectionComboBox.Clear; IniFile.ReadSections(SectionComboBox.Items);{ 选择system.ini文件的第一个节名 } SectionComboBox.ItemIndex:=0; SectionComboBoxChange(Sender); CmdSave.Enabled:=False;end; { 将组合列表框IniComboBox中所选择节中对应的各个变量及对应的值送入多行文本编辑器IniMemo中 }procedure TIniForm.SectionComboBoxChange(Sender: TObject);begin IdentComboBox.Clear; IniFile.ReadSection(SectionComboBox.Text, IdentComboBox.Items); IdentComboBox.ItemIndex:=0; IdentComboBoxChange(Sender);end; procedure TIniForm.IdentComboBoxChange(Sender: TObject);begin IdentValueEdit.Enabled:=False; { 将选择的关键字值读入 } IdentValueEdit.Text:= IniFile.ReadString(SectionComboBox.Text, IdentComboBox.Text,'');end;
度曲
begin
i:=readinteger('section name','key name',defaultvalue);
b:=readbool(...);
....
writeinteger('secname',keyname',value);
free;
end;
;注释
[小节名]
关键字=值
...---- INI文件允许有多个小节,每个小节又允许有多个关键字, “=”后面是该关键字的值。
---- 值的类型有三种:字符串、整型数值和布尔值。其中字符串存贮在INI文件中时没有引号,布尔真值用1表示,布尔假值用0表示。
---- 注释以分号“;”开头。 二、定义
---- 1、在Interface的Uses节增加IniFiles;
---- 2、在Var变量定义部分增加一行:
myinifile:Tinifile;
---- 然后,就可以对变量myinifile进行创建、打开、读取、写入等操作了。 三、打开INI文件
myinifile:=Tinifile.create('program.ini');
--- 上面这一行语句将会为变量myinifile与具体的文件 program.ini建立联系,然后,就可以通过变量myinifile,来读写program.ini文件中的关键字的值了。 ---- 值得注意的是,如果括号中的文件名没有指明路径的话,那么这个Program.ini文件会存储在Windows目录中,把Program.ini文件存储在应用程序当前目录中的方法是:为其指定完整的路径及文件名。下面的两条语句可以完成这个功能:
Filename:=ExtractFilePath(Paramstr(0))+'program.ini';
myinifile:=Tinifile.Create(filename);四、读取关键字的值
--- 针对INI文件支持的字符串、整型数值、布尔值三种数据类型,TINIfiles类提供了三种不同的对象方法来读取INI文件中关键字的值。
--- 假设已定义变量vs、vi、vb分别为string、 integer、boolean类型。
vs:=myinifile.Readstring('小节名','关键字',缺省值);
vi:=myinifile.Readinteger('小节名','关键字',缺省值);
vb:=myinifile.Readbool('小节名','关键字',缺省值);--- 其中缺省值为该INI文件不存在该关键字时返回的缺省值。 五、写入INI文件
---- 同样的,TInifile类也提供了三种不同的对象方法,向INI文件写入字符串、整型数及布尔类型的关键字。
myinifile.writestring('小节名','关键字',变量或字符串值);
myinifile.writeinteger('小节名','关键字',变量或整型数值);
myinifile.writebool('小节名','关键字',变量或True或False);
---- 当这个INI文件不存在时,上面的语句还会自动创建该INI文件。 六、删除关键字
---- 除了可用写入方法增加一个关键字,Tinifile类还提供了一个删除关键字的对象方法:
myinifile.DeleteKey('小节名','关键字');七、小节操作
--- 增加一个小节可用写入的方法来完成,删除一个小节可用下面的对象方法:
myinifile.EraseSection('小节名');--- 另外Tinifile类还提供了三种对象方法来对小节进行操作:
--- myinifile.readsection('小节名',TStrings变量);可将指定小节中的所有关键字名读取至一个字符串列表变量中;
--- myinifile.readsections(TStrings变量);可将INI文件中所有小节名读取至一个字符串列表变量中去。
---- myinifile.readsectionvalues('小节名',TStrings变量);可将INI文件中指定小节的所有行(包括关键字、=、值)读取至一个字符串列表变量中去。 八、释放
在适当的位置用下面的语句释放myinifile:
myinifile.distory;九、一个实例
---- 下面用一个简单的例子(如图),演示了建立、读取、存贮INI文件的方法。myini.ini文件中包含有“程序参数”小节,和用户名称(字符串)、是否正式用户(布尔值)和已运行时间(整型值)三个关键字。程序在窗体建立读取这些数据,并在窗体释放时写myini.ini文件。 --- 附源程序清单
unit Unit1;interface
uses Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs,inifiles,StdCtrls, ExtCtrls;type
TForm1 = class(TForm)
Edit1: TEdit;
CheckBox1: TCheckBox;
Edit2: TEdit;
Label1: TLabel;
Label2: TLabel;
Timer1: TTimer;
Label3: TLabel;
procedure FormCreate(Sender: TObject);
procedure FormDestroy(Sender: TObject);
procedure Timer1Timer(Sender: TObject);
private
{ Private declarations }
public
{ Public declarations }
end;
var
Form1: TForm1;implementation
var
myinifile:TInifile;
{$R *.DFM}procedure TForm1.FormCreate(Sender: TObject);
var
filename:string;
begin
filename:=ExtractFilePath(paramstr(0))+'myini.ini';
myinifile:=TInifile.Create(filename);
edit1.Text:= myinifile.readstring('程序参数','用户名称','缺省的用户名称');
edit2.text:= inttostr(myinifile.readinteger('程序参数','已运行时间',0));
checkbox1.Checked:= myinifile.readbool('程序参数','是否正式用户',False);
end;procedure TForm1.FormDestroy(Sender: TObject);
begin
myinifile.writestring('程序参数','用户名称',edit1.Text);
myinifile.writeinteger('程序参数','已运行时间',strtoint(edit2.text));
myinifile.writebool('程序参数','是否正式用户',checkbox1.Checked);
myinifile.Destroy;
end;procedure TForm1.Timer1Timer(Sender: TObject);
begin
edit2.Text:=inttostr(strtoint(edit2.text)+1);
end;end.
再read*** or write***
最后
free