Click here to Skip to main content
Click here to Skip to main content

Ini Handler

, 2 Jun 2004
Rate this:
Please Sign up or sign in to vote.
Permits simple access to ini files


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:

# Optional
# multiline
# comment


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();

// if Global would be a category, this lists all keys:
string[] keysInGlobal = Ini.GetKeys("Global");
// and if testkey would be a key in 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?


  • April 17th : First version.
  • May 29th : Bugfix - IniStructure.ReadIni(string) can now read read-only ini files because it opens the file with the FileAccess.Read param.


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author


Switzerland Switzerland
I left the Microsoft world, and am now working with linux and a BSD. This switch was a big relief, mostly for my keyboard, which doesn't get slammed again.
A big thank you to those who helped me with their good articles.

Comments and Discussions

Questionopen source licence question Pinmembergemsi7-Jan-15 22:54 
Questionsections bug PinmemberMember 770255324-Feb-11 8:02 
GeneralDeleteCategory doesn't work to me PinmembercH40z-Lord9-Oct-07 3:22 
GeneralNini PinmemberMattman2061-Aug-06 12:37 
Generalencoding problem. Pinmembermargiex27-Feb-06 17:17 
GeneralSorting PinmemberCemeron31-Jan-06 12:39 
GeneralTiny bugfix PinmemberRolf Therkildsen16-Aug-05 21:37 
QuestionAnother version without SortedList??? PinmemberWayneC3-May-05 23:05 
Generaldownload error PinsussBarraq31-Jul-04 2:09 
GeneralRe: download error Pinmemberkratchkov1-Aug-04 21:38 
GeneralImprovement PinmemberAlex Rovner29-Jul-04 14:22 
GeneralRe: Improvement Pinmemberkratchkov1-Aug-04 21:38 
GeneralRe: Improvement PinmemberAlex Rovner2-Aug-04 6:34 
GeneralRe: Improvement Pinmemberkratchkov4-Aug-04 9:56 
GeneralRe: Improvement Pinmemberquintonviljoen22-Dec-04 20:38 
GeneralRe: Improvement PinmemberAndyYerg1-Mar-07 9:24 
Generalsmall mistake PinmemberFilip Geens7-Jul-04 23:00 
GeneralRe: small mistake Pinmemberlokeshdeshmukh16-Jun-08 0:33 
GeneralForm PinmemberFilip Geens7-Jul-04 22:41 
GeneralRe: Form Pinmemberkratchkov8-Jul-04 11:10 
Okay, it would be better. But I think that it's just a demo app to show the use of the class. I don't really care for the form. Wink | ;-)
Instead of printing "No errors have been found", a compiler should rather print "None of your errors have been found", which would be, in most cases, true.

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.150327.1 | Last Updated 3 Jun 2004
Article Copyright 2004 by kratchkov
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid