TIniFile. Работа с Ini-файлами в Delphi. 



Что такое Ini файл?

  Ini файлы – это простые текстовые файлами с расширением .ini(в принципе можно и с любым другим). Обычно они хранятся в каталоге Windows. Ini файлы предназначены для хранения настроек программы. 

Ini файлы разделены на разделы, содержащие идентификаторы, которым, в свою очередь, можно присвоить значения. 
В общем виде структура Ini файла такова:



  Выражение  Идентификатор = Значение очень часто называют ключом.

  В Delphi работа с Ini файлами производится посредствам класса TIniFile, объявленного в юните IniFiles. TIniFile наследуется от класса TCustomIniFile, который в свою очередь, является прямым потомком TObject.



Теперь рассмотрим свойства и методы класса TIniFile.



Метод Create.

  Объявлен как:



  Метод Create создает экземпляр класса TIniFile, который позволяет манипулировать Ini файлом, имя которого передаётся в параметре FileName. 
  Если явно не указать, где именно нужно создать или найти Ini файл, Ваша программа будет искать его  в каталоге Windows.


Пример:






Свойство FileName.

  Объявлено как:



  Это read only свойство хранит в себе имя Ini файла.
Значение FileName присваивается только один раз во время работы с экземпляром класса TIniFile – в методе Create.

Пример:



PS:  Для работы данного примера так же следует подключить модуль Dialogs, так как в нем объявлена процедура ShowMessage.


 
Методы WriteString, ReadString.

Объявлены следующим образом:


    
Процедура WriteString записывает в раздел Section, в ключ с идентификатором Ident строку Value.

Функция ReadString читает из раздела Section строку из ключа с идентификатором Ident. Если такой раздел или ключ не обнаружены в файле, то функция вернет заданный Вами параметр Default.


Пример:
  
        



Методы WriteInteger, ReadInteger.

Объявлены как:



Процедура WriteInteger записывает в ключ Ident находящийся в разделе Section целое число Value. 

Функция ReadInteger читает целое число из ключа с идентификатором Ident находящегося в разделе Section.

PS: На самом деле в файл будут записаны не числа, а строки. То есть в WriteInteger в файл пишется не само Value, а преобразованное в строку число -  IntToStr(Value). А в ReadInteger читается сначала строка, а в результате передаётся строка, преобразованная в число с помощью функции StrToInt.

Пример:
  См. примеры к методам ReadString, WriteString.



Методы WriteFloat, ReadFloat.

Объявлены как:


Процедура WriteFloat записывает в ключ Ident находящийся в разделе Section натуральное число Value. 

Функция ReadFloat читает натуральное число из ключа с идентификатором Ident находящегося в разделе Section.

PS: Аналогично Write(Read)Integer в файл пишется не само число, а строки. Но в ReadFloat, если не удастся сконвертировать строку в натуральное число, поднимется исключение типа EConvertError.

Пример:
  См. примеры к методам ReadString, WriteString.



Методы WriteBool, ReadBool.

Объявлены как:



Процедура WriteBool записывает в ключ Ident находящийся в разделе Section натуральное число Value. 

Функция ReadBool читает натуральное число из ключа с идентификатором Ident находящегося в разделе Section.

PS: Аналогично Write(Read)Integer(Float) в файл пишется не само число, а строки. Точнее либо '1', либо '0'. 

Пример:
  См. примеры к методам ReadString, WriteString. 



Методы WriteDate, ReadDate. 

Объявлены как:




  WriteDate записывает в раздел с именем Section ключ с идентификатором Name и значением Value. 

  Функция ReadDate читает значение ключа с идентификатором Name, находящегося в разделе Section. Если ключ не найден, то результатом работы функции будет параметр Default. Если в ключе находится значение отличное от типа TDateTime, будет поднято исключение EConvertError. Так же как и во всех предыдущих методах чтения/записи, в Ini файле, после записи в него даты, будут находится строки, а при чтении будет выполнено преобразование в TDateTime.


Пример:


        



Методы WriteTime, ReadTime.

Объявлены как:


    
  WriteTime, ReadTime являются полными копиями WriteDate, ReadDate, но пишут не дату, а время.

Пример:
  См. Пример к методам WriteDate, ReadDate.


Методы WriteDateTime, ReadDateTime.

Объявлены как:



Эти два метода класса TIniFile записывают в файл дату и время и соответственно читают их. В остальном они схожи с WriteDate и ReadDate. 
                            
Пример:
  См. Пример к методам WriteDate, ReadDate.



Методы WriteBinaryStream, ReadBinaryStream.

Объявлены как:
   


  Процедура WriteBinaryStream записывает в ключ с идентификатором Name раздела Section данные из потока Value. Во время работы процедуры данные из потока преобразуются в шестнадцатеричную строку, и уже после этого записываются в файл.   

  Функция ReadBinaryStream читает в поток Value значение ключа с идентификатором Name, находящегося в разделе Section. Результатом является размер потока.

Пример:
  Положите на форму компонент TMemo и две кнопки(TButton).





Метод ReadSection.

Объявлен как:



Читает все идентификаторы ключей в разделе Section и заносит их в Strings.

Пример:

  Положите на форму компонент TMemo.

         

  
Результат:

  В Memo1 отобразится следующий список:





               
Метод ReadSections.

Объявлен как:
 


Читает имена всех разделов в Ini файле и заносит их в Strings.

Пример:

  Положите на форму компонент TMemo.

            

  
Результат:

  В Memo1 отобразится следующий список:





Метод ReadSectionValues.

Объявлен как:
    


Читает все ключи (идентификатор=значние) в разделе Section и заносит их в Strings.

Пример:

  Положите на форму компонент TMemo.

           


Результат:

  В Memo1 отобразится следующий список:




Метод DeleteKey.

Объявлен как:



  Метод DeleteKey удаляет из Ini файла ключ в разделе Section с идентификатором Ident.

Пример:





Метод EraseSection.

Объявлен как:   
  


  Метод EraseSection удаляет целый раздел из Ini файла. Параметр Section – имя раздела, который надо удалить.


Пример:






Метод ValueExists.

Объявлен в виде следующей функции:    



  Функция проверяет наличие ключа с идентификатором Ident в разделе Section Ini файла. Если данный ключ в разделе присутствует - функция вернет true, иначе false.

Пример:

       



Метод SectionExists.

Объявлен в виде функции:    



  Функция проверяет наличие раздела Section в Ini файле. Если данный раздел в файле присутствует - функция вернет true, иначе false.

Пример:
        


Это сообщение отредактировал(а) THandle - 17.7.2008, 17:02

Молоток=)))   

А для работы с реестром статейка будет? ))

Ofer, да, наверное.  

ЗЫ: Если найдете ошибки, опечатки, неточности и тд., пожалуйста, напишите об этом в PM, исправлю.  

Есть способ хранить настройки и данные в файле *.dat. Такой способ лучше тем, что прочитать его содержимое (или изменить) - дело бесполезное. 

А у меня и из папки программы (а не Windows) нормально открывается ini-файл. Вот так открываю файл, с тем же именем, что и exe-шник, но расширением ini:

  Там же написано ОБЫЧНО. Это не значит, что обязательно, это ближе к слову ЧАСТО или ПРИНЯТО. Можно куда угодно его сувать.

Это точно! Есть у меня знакомый, так он ini с настройками в ресурсы dll пихает (ну у него там в этой dll картинки, формы. Он туда и настройки сует) 

Я имел в виду, что если не указывать путь, а только имя файла, то он будет искаться при открытии  в папке программы, а не в папке Windows

ksili, хорошо, давайте напишем такой вот примерчик:

На формочку кидаем две кнопочки и в ОнКлик их пишем следущее:




Сохраняем весь "проект" в какую - нибудь папку.

Теперь запускаем эту программу. Жмем первую кнопку. В проводнике открываем каталог Windows. Вот он наш файл - Ini.ini. Создан именно в каталоге Windows, а не нашей программы. Теперь перемещаем этот файл в каталог нашей программы. Именно перемещаем, а не копируем. 
Программа наша всё это время работает. 
Теперь жмем вторую кнопку.
Результат: файл не найден, хотя находится в каталоге нашей программы, ключ невозможно прочитать, и поэтому в сообщении показывается не записанное нами в значение, а параметр Default равный в данном случае 'Not found'.


Вывод: если явно не указать программе где искать Ini файл, она будет искать его в каталоге Windows.

а-а-а, я понял в чём прикол: в Application->ExeName из моего примера входит полный путь до exe-шника

Угу.   

Нужно еще заметить, что ИНИ-файл в win98 не может превышать размер 64 кб, и естественно если мы не указываем полный путь, то ини-файл сохраняется в папке windows, думаю это не очень красиво...   просто безобразие)))... Можно было еще бы упомянуть про TMemIniFile...    Я сам придерживаюсь ини-файлов, да ну этот реестр... терпеть не могу когда люди там хранят например параметры окна и еще всякую... *** 

Думал над этим, но как мне кажется Win98 начинающие программисты сейчас не используют.


Это уже описано  


Про него то я и напишу в следующей после реестра статье.



Это сообщение отредактировал(а) THandle - 26.2.2008, 18:00

Зашёл поглядеть, толковая статья вышла