Delphi ini文件 [2] TIniFile 属性和方法
Delphi ini文件 [2] TIniFile 属性和方法
1、TIniFile对象
TIniFile对象，将.INI文件封装在其中，并提供一些方法，专门用来对INI文件进行读写操作。如果在程序中要用到TIniFile类或其方法属性，就必须在程序单元的uses语句中手工加入对IniFiles单元的引用。
2、方法
2.1 Create 用来创建一个处理INI文件的TIniFile类型实例。
- 方法声明：constructor Create(const FileName:string);
- 参数说明：FileName指明待创建的INI文件的文件名；
- 注释：在使用TIniFile对象之前，必须先用此方法创建一个INI文件的实例。FileName中可以包含路径名，缺省时为Windows所在目录（一般就是C:windows，对于Windows NT来说，则一般是c:winnt)。用Create方法创建的实例，在使用完之后，调用Free方法释放内存。
2.2 ReadSection 从INI文件中读出指定段的所有子键名，并存入Strings参数指定的字符串列表对象中。
- 方法声明：procedure ReadSection(const Section:string; Strings:TStrings);
- 参数说明：Section指明要读取段的段名；
- Strings指明存放子键名的字符串列表；
- 注释：ReadSection方法仅读入指定段的所有子键名，但不读入子键的值。
2.3 ReadSections 从INI文件中读取所有段名，并存入Strings参数指定的字符中列表中。
- 方法声明：procedure ReadSections(Strings:TStrings);
- 参数说明：Strings参数指明存放段名的字符串列表；
- 注释：ReadSections方法将INI文件中所有段的段名读出，存入一指定的字符串列表中，此字符串列表可以直接使用某个列表框的Items属性。
2.4 ReadSectionValues 从INI文件中读入指定段的所有子键名及其键值，并存入Strings参数指定的字符串列表中。
- 方法声明：procedure ReadSectionValues(const Section:String; Strings:TStrings);
- 参数说明：Section指明要读取段的段名；
- Strings指明存放段名的字符串列表；
- 注释：ReadSectionValues方法与ReadSection方法的区别在于后者仅读入子键名，面前者除了读取子键名之外，还读取该子键对应的键值。读入的子键名及键值在字符串列表中的存放方法与在文件中的显示方法一致，即"Key=Value"形式。
2.5 EraseSection 删除INI文件中指定的一个整段。
- 方法声明：procedure EraseSection(const Section:string);
- 参数说明：Section指明待删除段的段名；
- 注释：EraseSection方法不仅删除指定段的段名，面且同时将该段的所有子键及键值删除。
2.6 DeleteKey删除指定段中的某个指定的子键。
- 方法声明：procedure DeleteKey(const Section，Key:string);
- 参数说明：Section指明待删除子键据段的段名；
- Key指明待删除子键的键名；
- 注释：DeleteKey方法删除整个子键（包括键名和键值)，也就是删除该子键所在的一行。
2.7 ReadBool 读取指定段的某个子键的布尔值。
- 方法声明：function ReadBool(const Section，Key:string;Default:Boolean):Boolean;
- 参数说明：Section指明待读子键所在段的段名；
- Key指明待读子键的键名；
- Default参数指明缺省时的返回值。
- 注释：ReadBool方法用于读取一个子键的布尔型值，当键值为"1"时，返回True，键值为"0"时，返回False.
2.8 WriteBool 向指定段的某个子键写入布尔值。
- 方法声明：procedure WriteBool(const Section， Key:string; Value:Boolean);
- 参数说明：Senction指明待写入子键所在段的段名；
- Key参数指明待写入值的子键键名；
- Value指明待写入的布尔值；
- 注释：WriteBool 方法用于写入一个子键的布尔值，当Value为"True"时，写入"1"。Value为"Flase"时，写入"0"。若在写入时，指定的段或键名不存在，则自动创建该段和键名。
2.9 ReadInteger 读取指定段的某个子键的整型值。
- 方法声明：function ReadInteger(const Section，Key:string; Default:longint):longint;
- 注释：此方法与ReadBool方法类似，只是变量类型不同。
2.10 WriteInteger向指写段的某个子键写放整型值。
- 方法声明：procedure WriteInteger(const Section，Key:string; Value:longint);
- 注释：此方法与WriteBool方法类似，只是变量灰型不同。
2.11 ReadString读取指定段的某个子键的字符串型 值。
- 方法声明：function ReadString(const Section，Key:string; Default:string):string;
- 注释；此方法与ReadBool方法类似，只是变量类型不同。
2.12、WriteString 向指写段的某个子键写入整型值。
- 方法声明：procedure WriteString(const Section，Key:string; Value:string);
- 注释：此方法与WriteBool方法类似，只是变量类型不同。
2.13、SectionExists 判断某个小节是否存在 。例如：SectionExists('小节');
2.14、ValueExists 判断某个关键字的值是否存在。例如：ValueExists('小节','关键值');
3、属性
3.1 FileName指明被封装在TIniFile对象中的INI文件的文件名。
- 属性声明：property FileName:string;
- 注释：FileName属性是一个运行时的只读属性。
创建时间：2020.12.01 更新时间：2021.03.16
