Click here to Skip to main content
12,701,051 members (26,842 online)
Click here to Skip to main content
Add your own
alternative version


158 bookmarked

An INI file handling class using C#

, 14 Mar 2002
Rate this:
Please Sign up or sign in to vote.
A C# class that exposes the INI file handling functions from Kernal32.dll
<!-- Download Links --> <!-- Add the rest of your HTML here -->


I created a C# class Ini which exposes 2 functions from KERNEL32.dll. These functions are: WritePrivateProfileString and GetPrivateProfileString

Namespaces you will need: System.Runtime.InteropServices and System.Text

The Class

using System;
using System.Runtime.InteropServices;
using System.Text;

namespace Ini
    /// <summary>
    /// Create a New INI file to store or load data
    /// </summary>
    public class IniFile
        public string path;

        private static extern long WritePrivateProfileString(string section,
            string key,string val,string filePath);
        private static extern int GetPrivateProfileString(string section,
                 string key,string def, StringBuilder retVal,
            int size,string filePath);

        /// <summary>
        /// INIFile Constructor.
        /// </summary>
        /// <PARAM name="INIPath"></PARAM>
        public IniFile(string INIPath)
            path = INIPath;
        /// <summary>
        /// Write Data to the INI File
        /// </summary>
        /// <PARAM name="Section"></PARAM>
        /// Section name
        /// <PARAM name="Key"></PARAM>
        /// Key Name
        /// <PARAM name="Value"></PARAM>
        /// Value Name
        public void IniWriteValue(string Section,string Key,string Value)
        /// <summary>
        /// Read Data Value From the Ini File
        /// </summary>
        /// <PARAM name="Section"></PARAM>
        /// <PARAM name="Key"></PARAM>
        /// <PARAM name="Path"></PARAM>
        /// <returns></returns>
        public string IniReadValue(string Section,string Key)
            StringBuilder temp = new StringBuilder(255);
            int i = GetPrivateProfileString(Section,Key,"",temp, 
                                            255, this.path);
            return temp.ToString();


Using the class

Steps to use the Ini class:

  1. In your project namespace definition add 
    using INI;
  2. Create a INIFile like this
    INIFile ini = new INIFile("C:\\test.ini");
  3. Use IniWriteValue to write a new value to a specific key in a section or use IniReadValue to read a value FROM a key in a specific Section.

That's all. It's very easy in C# to include API functions in your class(es).


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

Web Developer
Canada Canada
No Biography provided

You may also be interested in...


Comments and Discussions

QuestionSimple and great class Pin
Member 1038226927-Apr-14 3:41
memberMember 1038226927-Apr-14 3:41 
SuggestionSuggestion Pin
Nathan Ferreira Dos Santos30-Jan-14 14:41
memberNathan Ferreira Dos Santos30-Jan-14 14:41 
GeneralMy vote of 5 Pin
Elena Futornyak14-Jun-13 2:16
memberElena Futornyak14-Jun-13 2:16 
Questionoverwriting Pin
Member 998609411-Jun-13 17:06
memberMember 998609411-Jun-13 17:06 
GeneralMy vote of 5 Pin
Amogh Natu27-May-13 5:52
professionalAmogh Natu27-May-13 5:52 
GeneralMy vote of 5 Pin
jai_magical16-Apr-13 12:40
memberjai_magical16-Apr-13 12:40 
GeneralMy vote of 5 Pin
Saravanan.rex5-Sep-12 5:00
memberSaravanan.rex5-Sep-12 5:00 
GeneralRe: My vote of 5 Pin
Headzup27-Sep-12 3:16
memberHeadzup27-Sep-12 3:16 
GeneralRe: My vote of 5 Pin
Saravanan.rex27-Sep-12 8:23
memberSaravanan.rex27-Sep-12 8:23 
QuestionFormClosing Pin
paphnuty27-Aug-12 22:38
memberpaphnuty27-Aug-12 22:38 
Questionmy vote of 5 Pin
velt_99124-Apr-12 22:09
membervelt_99124-Apr-12 22:09 
QuestionIf you want to support unicode, use this. Pin
chozekun12-Mar-12 22:11
memberchozekun12-Mar-12 22:11 
GeneralMy vote of 5 Pin
koiser13-Feb-12 4:51
memberkoiser13-Feb-12 4:51 
GeneralMy vote of 5 Pin
sanket_14@rediff.com1-Nov-11 21:40
membersanket_14@rediff.com1-Nov-11 21:40 
GeneralMy vote of 5 Pin
Ali Fakoor21-Oct-11 22:44
memberAli Fakoor21-Oct-11 22:44 
QuestionRead and write ini files in VB.Net Pin
Nasenbaaer5-Oct-11 4:46
memberNasenbaaer5-Oct-11 4:46 
GeneralMy vote of 5 Pin
Nasenbaaer5-Oct-11 4:45
memberNasenbaaer5-Oct-11 4:45 
Questionhave 5 stars Pin
Shivamkalra22-Jun-11 19:57
memberShivamkalra22-Jun-11 19:57 
Question5 star Pin
Shivamkalra22-Jun-11 19:56
memberShivamkalra22-Jun-11 19:56 
RantOK Pin
mebaba13-May-11 0:06
membermebaba13-May-11 0:06 
GeneralMy vote of 5 Pin
Member 4458079 Jose5-May-11 16:35
memberMember 4458079 Jose5-May-11 16:35 
GeneralMy vote of 5 Pin
dv7617-Mar-11 23:20
memberdv7617-Mar-11 23:20 
Generalsuggestion to add some more methods to this class. Pin
hugoandrioli@yahoo.com28-Dec-10 1:15
memberhugoandrioli@yahoo.com28-Dec-10 1:15 
GeneralRe: suggestion to add some more methods to this class. Pin
md5sum5-Jan-11 10:28
membermd5sum5-Jan-11 10:28 
GeneralRe: suggestion to add some more methods to this class. Pin
(^-^)h~ugo5-Jan-11 12:45
member(^-^)h~ugo5-Jan-11 12:45 
GeneralRe: suggestion to add some more methods to this class. [modified] Pin
md5sum5-Jan-11 13:02
membermd5sum5-Jan-11 13:02 
I suppose if you need that much granularity in your error reporting, then it would be necessary to report it that way. However, I would probably instead change:
throw new IniFileException("Tried to retrieve invalid value type from ini.");

throw new IniFileException(string.Format("Tried to retrieve invalid value type from ini. Tried to convert \"{0}\" to int.", s));

in order to introduce the same level of reporting the cause of the error without the granularity of exception types generated through the alternate, multiple catch method. I can't imagine an instance where I would need (for myself or my users) to have more than a single exception generated from this block of code. In general though, if you absolutely want to keep the InnerException and specifically NOT use a TryParse, I would limit it to simply:
    i = Convert.ToInt32(s);
catch (Exception ex)
    throw new IniFileException("Tried to retrieve invalid value type from ini.", ex);

and add the following constructor back to the IniFileException class:
public IniFileException(string Message, Exception ex)
    : base(Message, ex)


This will keep your granularity in exception types, rethrowing the wrapped exception with an appropriate InnerException. I just can't imagine why you would want that in this particular case.
modified on Friday, January 7, 2011 2:38 PM

GeneralRe: suggestion to add some more methods to this class. Pin
tttony076-Mar-11 16:48
membertttony076-Mar-11 16:48 
GeneralRe: suggestion to add some more methods to this class. Pin
Member 922029317-Feb-14 9:55
memberMember 922029317-Feb-14 9:55 
GeneralStrings longer than 254 characters will be truncated. Pin
dgph21-Nov-10 18:34
memberdgph21-Nov-10 18:34 
GeneralRe: Strings longer than 254 characters will be truncated. Pin
f.rivato16-Jan-13 22:35
memberf.rivato16-Jan-13 22:35 
GeneralMy vote of 3 Pin
Daniel Moreland4-Nov-10 13:10
memberDaniel Moreland4-Nov-10 13:10 
GeneralUnable to add multiple record Pin
sammizai5-Oct-10 0:58
membersammizai5-Oct-10 0:58 
AnswerRe: Unable to add multiple record Pin
shrutigupta2124-Dec-10 8:49
membershrutigupta2124-Dec-10 8:49 
GeneralRe: Unable to add multiple record Pin
kytro36028-Oct-12 6:53
memberkytro36028-Oct-12 6:53 
GeneralGreat Job Pin
sos.crow16-Jul-09 17:50
membersos.crow16-Jul-09 17:50 
GeneralCode Update! Pin
Benjamin Ethington16-Jun-09 10:31
memberBenjamin Ethington16-Jun-09 10:31 
GeneralRe: Code Update! - ConvertIni2Xml Pin
Thymine4-Aug-09 9:27
memberThymine4-Aug-09 9:27 
GeneralRe: Code Update! Pin
thund3rstruck18-Sep-09 5:46
memberthund3rstruck18-Sep-09 5:46 
GeneralAdded some methods to manage additional data types (read) Pin
Nyarlatotep16-Jun-09 0:42
memberNyarlatotep16-Jun-09 0:42 
GeneralRe: Added some methods to manage additional data types (read) Pin
Ali Fakoor21-Oct-11 22:25
memberAli Fakoor21-Oct-11 22:25 
GeneralRe: Added some methods to manage additional data types (read) Pin
Nyarlatotep21-Oct-11 22:40
memberNyarlatotep21-Oct-11 22:40 
GeneralUsing this class in a aspx web application Pin
Scott Reid4-Mar-09 13:47
memberScott Reid4-Mar-09 13:47 
GeneralHits the spot Pin
HibbertM13-Feb-09 1:23
memberHibbertM13-Feb-09 1:23 
GeneralThanks Pin
NAMhatre18-Sep-08 8:47
memberNAMhatre18-Sep-08 8:47 
Questionlicensing? Pin
Nick Trown14-Aug-08 11:47
memberNick Trown14-Aug-08 11:47 
Generala question Pin
gyue31-Jul-08 22:18
membergyue31-Jul-08 22:18 
GeneralBad path Pin
arj200018-Jul-08 4:32
memberarj200018-Jul-08 4:32 
GeneralRe: Bad path Pin
Batzen17-Feb-09 2:11
memberBatzen17-Feb-09 2:11 
GeneralNo Using API Windows (Kernel 32) Pin
colijunior8-Jul-08 11:56
membercolijunior8-Jul-08 11:56 
Generalexception Pin
fangar13-May-08 5:45
memberfangar13-May-08 5:45 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    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
Web02 | 2.8.170118.1 | Last Updated 15 Mar 2002
Article Copyright 2002 by BLaZiNiX
Everything else Copyright © CodeProject, 1999-2017
Layout: fixed | fluid