Click here to Skip to main content
11,412,451 members (64,647 online)
Click here to Skip to main content

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

Comments and Discussions

GeneralThanks Pin
Member 11366023 at 4-Mar-15 15:36
memberMember 113660234-Mar-15 15:36 
GeneralThanks Pin
meridbt at 27-Feb-15 0:35
membermeridbt27-Feb-15 0:35 
QuestionTrouble with relative paths [modified] Pin
feraudy at 16-Feb-15 10:58
memberferaudy16-Feb-15 10:58 
GeneralMy vote of 1 Pin
Member 10509392 at 19-Nov-14 13:23
memberMember 1050939219-Nov-14 13:23 
QuestionCann't able to Write values in Ini file Pin
Devendra lodha at 16-Oct-14 0:36
memberDevendra lodha16-Oct-14 0:36 
AnswerRe: Cann't able to Write values in Ini file Pin
Garth J Lancaster at 16-Oct-14 0:56
memberGarth J Lancaster16-Oct-14 0:56 
GeneralRe: Cann't able to Write values in Ini file Pin
Devendra lodha at 16-Oct-14 1:14
memberDevendra lodha16-Oct-14 1:14 
GeneralRe: Cann't able to Write values in Ini file Pin
Garth J Lancaster at 16-Oct-14 1:42
memberGarth J Lancaster16-Oct-14 1:42 
Questionwhat WritePrivateProfileString returns Pin
Devendra lodha at 15-Oct-14 22:51
memberDevendra lodha15-Oct-14 22:51 
Questionmy vote i 5 of 5 Pin
TorbjornWave at 2-Oct-14 1:54
memberTorbjornWave2-Oct-14 1:54 
GeneralMy Vote of 5 Pin
Szymon Roslowski at 6-Aug-14 6:49
memberSzymon Roslowski6-Aug-14 6:49 
QuestionSimple and great class Pin
Member 10382269 at 27-Apr-14 3:41
memberMember 1038226927-Apr-14 3:41 
SuggestionSuggestion Pin
Nathan Ferreira Dos Santos at 30-Jan-14 14:41
memberNathan Ferreira Dos Santos30-Jan-14 14:41 
GeneralMy vote of 5 Pin
Elena Futornyak at 14-Jun-13 2:16
memberElena Futornyak14-Jun-13 2:16 
Questionoverwriting Pin
Member 9986094 at 11-Jun-13 17:06
memberMember 998609411-Jun-13 17:06 
GeneralMy vote of 5 Pin
Amogh Natu at 27-May-13 5:52
professionalAmogh Natu27-May-13 5:52 
GeneralMy vote of 5 Pin
jai_magical at 16-Apr-13 12:40
memberjai_magical16-Apr-13 12:40 
GeneralMy vote of 5 Pin
Saravanan.rex at 5-Sep-12 5:00
memberSaravanan.rex5-Sep-12 5:00 
GeneralRe: My vote of 5 Pin
Headzup at 27-Sep-12 3:16
memberHeadzup27-Sep-12 3:16 
GeneralRe: My vote of 5 Pin
Saravanan.rex at 27-Sep-12 8:23
memberSaravanan.rex27-Sep-12 8:23 
i am using windows 7. please check the file path . use absolute path like @c:\temp.ini. if you put only file name then it's not creating ini file.
QuestionFormClosing Pin
paphnuty at 27-Aug-12 22:38
memberpaphnuty27-Aug-12 22:38 
Questionmy vote of 5 Pin
velt_991 at 24-Apr-12 22:09
membervelt_99124-Apr-12 22:09 
QuestionIf you want to support unicode, use this. Pin
chozekun at 12-Mar-12 22:11
memberchozekun12-Mar-12 22:11 
GeneralMy vote of 5 Pin
koiser at 13-Feb-12 4:51
memberkoiser13-Feb-12 4:51 
GeneralMy vote of 5 Pin at 1-Nov-11 21:40
membersanket_14@rediff.com1-Nov-11 21:40 

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
Web03 | 2.8.150427.1 | Last Updated 15 Mar 2002
Article Copyright 2002 by BLaZiNiX
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid