This class (
IniHandler) permits Ini file access. The class represents the contents of the ini, and has functions to list, add, remove and rename categories (they would rather be sections, but ... whatever), and can list, create, delete, and modify key-value pairs. The class has static methods to read and write files.
Using the code
The only class is the
IniHandler class in which everything is implemented. It does not write every change directly to the file. You rather get all data, then modify it, and at last save it.
The first part handles all the structure:
All data is saved in one
System.Collections.SortedList which contains the category names as keys, and all key-value pairs as values, saved as
SortedLists too. So this means there are
SortedLists in a
SortedList. That behaves like an array in an array, but with dynamic bounds and strings as indexers.
I hope you did understand this, it would have been easier to explain in French or German. You can of course list all categories, and all keys in a specified category. When you want to modify or read a value, you need to specify the categoryname and the keyname only.
This code is all you need to write an ini:
IniStructure Ini = new IniStructure();
IniStructure.WriteIni(Ini,"c:\filename.ini","Optional \n multiline \n comment");
The ini c:\filename.ini would then contain:
Each time you write, the file is cleared and rewritten from scratch.
To read an ini, it's very similar:
IniStructure Ini = IniStructure.ReadIni("C:\filename.ini");
string allCategories = Ini.GetCategories();
string keysInGlobal = Ini.GetKeys("Global");
string testKeyValue = Ini.GetValue("Global","testkey");
There are also methods to list the categories and the key-value pairs by index, but they are only used to iterate through all categories and keys during saving.
Points of Interest
It's the first time I use SortedLists, and first tried to write this without them, but I'm happy that I found them because it makes the code a lot simpler. There are some things to do, like error handling: because most methods only return bool, you can only know if an error occurred, but no more. Things like incorrect names (no '=', '[', ']' ... in category names etc..) are handled, but that's all. There's sure room for improvement, but, that's always the case, isn't it?