Click here to Skip to main content
Click here to Skip to main content
Go to top

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 -->

Introduction

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;

        [DllImport("kernel32")]
        private static extern long WritePrivateProfileString(string section,
            string key,string val,string filePath);
        [DllImport("kernel32")]
        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)
        {
            WritePrivateProfileString(Section,Key,Value,this.path);
        }
        
        /// <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).

License

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

Share

About the Author

BLaZiNiX
Web Developer
Canada Canada
No Biography provided

Comments and Discussions

 
GeneralMy Vote of 5 PinmemberSzymon Roslowski6-Aug-14 5:49 
QuestionSimple and great class PinmemberMember 1038226927-Apr-14 2:41 
SuggestionSuggestion PinmemberNathan Ferreira Dos Santos30-Jan-14 13:41 
GeneralMy vote of 5 PinmemberElena Futornyak14-Jun-13 1:16 
Questionoverwriting PinmemberMember 998609411-Jun-13 16:06 
GeneralMy vote of 5 PinprofessionalAmogh Natu27-May-13 4:52 
GeneralMy vote of 5 Pinmemberjai_magical16-Apr-13 11:40 
GeneralMy vote of 5 PinmemberSaravanan.rex5-Sep-12 4:00 
GeneralRe: My vote of 5 PinmemberHeadzup27-Sep-12 2:16 
GeneralRe: My vote of 5 PinmemberSaravanan.rex27-Sep-12 7:23 
QuestionFormClosing Pinmemberpaphnuty27-Aug-12 21:38 
Questionmy vote of 5 Pinmembervelt_99124-Apr-12 21:09 
QuestionIf you want to support unicode, use this. Pinmemberchozekun12-Mar-12 21:11 
GeneralMy vote of 5 Pinmemberkoiser13-Feb-12 3:51 
GeneralMy vote of 5 Pinmembersanket_14@rediff.com1-Nov-11 20:40 
GeneralMy vote of 5 PinmemberAli Fakoor21-Oct-11 21:44 
QuestionRead and write ini files in VB.Net PinmemberNasenbaaer5-Oct-11 3:46 
My piece of code in VB.Net
 
 <Runtime.InteropServices.DllImport("kernel32.dll", CharSet:=Runtime.InteropServices.CharSet.Ansi, SetLastError:=True)> _
            Private Function WritePrivateProfileString(Section As String, Key As String, Value As String, FilePath As String) As Long
            End Function
 
            <Runtime.InteropServices.DllImport("kernel32.dll", CharSet:=Runtime.InteropServices.CharSet.Ansi, SetLastError:=True)> _
            Private Function GetPrivateProfileString(Section As String, Key As String, DefaultValue As String, Result As System.Text.StringBuilder, Size As Integer, FilePath As String) As Long
            End Function
 

            ''' <summary>
            ''' Modify or create an value in an ini file. 
            ''' </summary>
            ''' <param name="FilePath">Path of ini file for example: C\Mydirectory\file.ini</param>
            ''' <param name="Section">Keyword Parent</param>
            ''' <param name="Key">Keyword</param>
            ''' <param name="Value">Value to store</param>
            ''' <returns>True if successfully</returns>
            ''' <remarks>Timo Böhme, www.goldengel.ch, info@goldengel.ch, http://msdn.microsoft.com/en-us/library/windows/desktop/ms724353%28v=vs.85%29.aspx
            ''' IniFileModifyValue:
            ''' If the function successfully copies the string to the initialization file, the return value is nonzero.</remarks>
            Public Function IniFileModifyValue(ByVal FilePath As String, ByVal Section As String, ByVal Key As String, ByVal Value As String) As Boolean
                Dim ret As Long
                Try
                    ret = WritePrivateProfileString(Section, Key, Value, FilePath)
                    If ret = 0 Then Return False
                Catch ex As Exception
                    Return False
                End Try
                Return True
            End Function
 

            ''' <summary>
            ''' Read an existing value in an ini file. Returns the default value if file or key does not exist.
            ''' </summary>
            ''' <param name="FilePath">Path of ini file for example: C\Mydirectory\file.ini</param>
            ''' <param name="Section">Keyword Parent</param>
            ''' <param name="Key">Keyword</param>
            ''' <param name="DefaultValue">Value to store</param>
            ''' <returns>The value from ini file</returns>
            ''' <remarks>http://msdn.microsoft.com/en-us/library/windows/desktop/ms724353%28v=vs.85%29.aspx
            ''' GetPrivateProfileString 
            ''' The return value is the number of characters copied to the buffer, not including the terminating null character.</remarks>
            Public Function IniFileReadSingleValue(FilePath As String, Section As String, Key As String, DefaultValue As String) As String
                Dim ret As Long
                Dim res As String = DefaultValue
                Dim sb As New System.Text.StringBuilder(255)
                If IO.File.Exists(FilePath) = True Then
 

                    ret = GetPrivateProfileString(Section, Key, DefaultValue, sb, sb.Capacity, FilePath)
                    If ret > 0 Then
                        ret = Global.System.Math.Min(ret, sb.Capacity) 'important! because ret could be more than 255
                        ret = Global.System.Math.Min(ret, sb.Length) 'important! because buffer can be unused and less than 255
                        res = sb.ToString(0, ret)
                    End If
                End If
 
                Return res
            End Function

GeneralMy vote of 5 PinmemberNasenbaaer5-Oct-11 3:45 
Questionhave 5 stars PinmemberShivamkalra22-Jun-11 18:57 
Question5 star PinmemberShivamkalra22-Jun-11 18:56 
RantOK Pinmembermebaba12-May-11 23:06 
GeneralMy vote of 5 PinmemberMember 4458079 Jose5-May-11 15:35 
GeneralMy vote of 5 Pinmemberdv7617-Mar-11 22:20 
Generalsuggestion to add some more methods to this class. Pinmemberhugoandrioli@yahoo.com28-Dec-10 0:15 
GeneralRe: suggestion to add some more methods to this class. Pinmembermd5sum5-Jan-11 9:28 
GeneralRe: suggestion to add some more methods to this class. Pinmember(^-^)h~ugo5-Jan-11 11:45 
GeneralRe: suggestion to add some more methods to this class. [modified] Pinmembermd5sum5-Jan-11 12:02 
GeneralRe: suggestion to add some more methods to this class. Pinmembertttony076-Mar-11 15:48 
GeneralRe: suggestion to add some more methods to this class. PinmemberMember 922029317-Feb-14 8:55 
GeneralStrings longer than 254 characters will be truncated. Pinmemberdgph21-Nov-10 17:34 
GeneralRe: Strings longer than 254 characters will be truncated. Pinmemberf.rivato16-Jan-13 21:35 
GeneralMy vote of 3 PinmemberDaniel Moreland4-Nov-10 12:10 
GeneralUnable to add multiple record Pinmembersammizai4-Oct-10 23:58 
AnswerRe: Unable to add multiple record Pinmembershrutigupta2124-Dec-10 7:49 
GeneralRe: Unable to add multiple record Pinmemberkytro36028-Oct-12 5:53 
GeneralGreat Job Pinmembersos.crow16-Jul-09 16:50 
GeneralCode Update! PinmemberBenjamin Ethington16-Jun-09 9:31 
GeneralRe: Code Update! - ConvertIni2Xml PinmemberThymine4-Aug-09 8:27 
GeneralRe: Code Update! Pinmemberthund3rstruck18-Sep-09 4:46 
GeneralAdded some methods to manage additional data types (read) PinmemberNyarlatotep15-Jun-09 23:42 
GeneralRe: Added some methods to manage additional data types (read) PinmemberAli Fakoor21-Oct-11 21:25 
GeneralRe: Added some methods to manage additional data types (read) PinmemberNyarlatotep21-Oct-11 21:40 
GeneralUsing this class in a aspx web application PinmemberScott Reid4-Mar-09 12:47 
GeneralHits the spot PinmemberHibbertM13-Feb-09 0:23 
GeneralThanks PinmemberNAMhatre18-Sep-08 7:47 
Questionlicensing? PinmemberNick Trown14-Aug-08 10:47 
Generala question Pinmembergyue31-Jul-08 21:18 
GeneralBad path Pinmemberarj200018-Jul-08 3:32 
GeneralRe: Bad path PinmemberBatzen17-Feb-09 1:11 
GeneralNo Using API Windows (Kernel 32) Pinmembercolijunior8-Jul-08 10:56 

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 | Mobile
Web03 | 2.8.140916.1 | Last Updated 15 Mar 2002
Article Copyright 2002 by BLaZiNiX
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid