using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading; using System.Runtime.InteropServices; using System.IO; namespace StandardLibrary { /// /// INI文件操作专用类 /// static class IniFile { #region API声明 /// /// 获取所有段落名称 /// /// 存放段落名称的内存地址,每个段落之间用\0分隔 /// 内存大小(characters) /// Ini文件 /// 内容的实际长度,为0表示没有内容,为nSize-2表示内存大小不够 [DllImport("kernel32.dll", CharSet = CharSet.Auto)] private static extern uint GetPrivateProfileSectionNames( IntPtr lpszReturnBuffer, uint nSize, string lpFileName ); /// /// 获取某个指定段落中所有KEY和Value /// /// 段落名称 /// 返回值的内存地址,每个之间用\0分隔 /// 内存大小(characters) /// Ini文件 /// 内容的实际长度,为0表示没有内容,为nSize-2表示内存大小不够 [DllImport("kernel32.dll", CharSet = CharSet.Auto)] private static extern uint GetPrivateProfileSection( string lpAppName, IntPtr lpReturnedString, uint nSize, string lpFileName ); /// /// 读取INI文件中指定的Key的值 /// /// 段落名称。如果为null,则读取INI中所有段落名称,每个节点名称之间用\0分隔 /// Key名称。如果为null,则读取INI中指定段落中的所有KEY,每个KEY之间用\0分隔 /// 读取失败时的默认值 /// 读取的内容缓冲区,读取之后,多余的地方使用\0填充 /// 内容缓冲区的长度 /// INI文件名 /// 实际读取到的长度 [DllImport("kernel32.dll", CharSet = CharSet.Auto)] private static extern uint GetPrivateProfileString( string lpAppName, string lpKeyName, string lpDefault, [In, Out] char[] lpReturnedString, uint nSize, string lpFileName ); //另一种声明方式,使用 StringBuilder 作为缓冲区类型的缺点是不能接受\0字符,会将\0及其后的字符截断, //所以对于lpAppName或lpKeyName为null的情况就不适用 [DllImport("kernel32.dll", CharSet = CharSet.Auto)] private static extern uint GetPrivateProfileString( string lpAppName, string lpKeyName, string lpDefault, StringBuilder lpReturnedString, uint nSize, string lpFileName ); //再一种声明,使用string作为缓冲区的类型同char[] [DllImport("kernel32.dll", CharSet = CharSet.Auto)] private static extern uint GetPrivateProfileString( string lpAppName, string lpKeyName, string lpDefault, string lpReturnedString, uint nSize, string lpFileName ); /// /// 将指定的键值对写到指定的段落,如果已经存在则替换。 /// /// 段落,如果不存在此段落,则创建此段落 /// Item键值对,多个用\0分隔,形如key1=value1\0key2=value2 /// 如果为string.Empty,则删除指定段落下的所有内容,保留段落 /// 如果为null,则删除指定段落下的所有内容,并且删除该段落 /// /// INI文件 /// 是否成功写入 [DllImport("kernel32.dll", CharSet = CharSet.Auto)] [return: MarshalAs(UnmanagedType.Bool)] //可以没有此行 private static extern bool WritePrivateProfileSection( string lpAppName, string lpString, string lpFileName ); /// /// 将指定的键和值写到指定的段落,如果已经存在则替换 /// /// 段落名称 /// 键名称。如果为null,则删除指定的段落及其所有的项目 /// 值内容。如果为null,则删除指定段落中指定的键。 /// INI文件 /// 操作是否成功 [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)] [return: MarshalAs(UnmanagedType.Bool)] private static extern bool WritePrivateProfileString( string lpAppName, string lpKeyName, string lpString, string lpFileName ); #endregion #region 封装 /// /// 读取INI文件中的所有段落名称 /// /// Ini文件 /// 所有段落,没有内容返回string[0] public static string[] INIGetAllSectionNames(string iniFile) { uint MAX_BUFFER = 32767; //默认为32767 string[] sections = new string[0]; //返回值 //申请内存 IntPtr pReturnedString = Marshal.AllocCoTaskMem((int)MAX_BUFFER * sizeof(char)); uint bytesReturned = GetPrivateProfileSectionNames(pReturnedString, MAX_BUFFER, iniFile); if (bytesReturned != 0) { //读取指定内存的内容 string local = Marshal.PtrToStringAuto(pReturnedString, (int)bytesReturned).ToString(); //每个段落之间用\0分隔,末尾有一个\0 sections = local.Split(new char[] { '\0' }, StringSplitOptions.RemoveEmptyEntries); } //释放内存 Marshal.FreeCoTaskMem(pReturnedString); return sections; } /// /// 获取INI文件中指定段落中的所有条目(key=value形式) /// /// Ini文件 /// 段落名称 /// 指定段落中的所有条目,没有内容返回string[0] public static string[] INIGetAllItems(string iniFile, string section) { //返回值形式为 key=value,例如 Color=Red uint MAX_BUFFER = 32767; //默认为32767 string[] items = new string[0]; //返回值 //分配内存 IntPtr pReturnedString = Marshal.AllocCoTaskMem((int)MAX_BUFFER * sizeof(char)); uint bytesReturned = GetPrivateProfileSection(section, pReturnedString, MAX_BUFFER, iniFile); if (!(bytesReturned == MAX_BUFFER - 2) || (bytesReturned == 0)) { string returnedString = Marshal.PtrToStringAuto(pReturnedString, (int)bytesReturned); items = returnedString.Split(new char[] { '\0' }, StringSplitOptions.RemoveEmptyEntries); } Marshal.FreeCoTaskMem(pReturnedString); //释放内存 return items; } /// /// 获取INI文件中指定段落中的所有条目的Key列表 /// /// Ini文件 /// 段落名称 /// 如果没有内容,反回string[0] public static string[] INIGetAllItemKeys(string iniFile, string section) { string[] value = new string[0]; const int SIZE = 1024 * 10; if (string.IsNullOrEmpty(section)) { throw new ArgumentException("必须指定段落名称", "section"); } char[] chars = new char[SIZE]; uint bytesReturned = GetPrivateProfileString(section, null, null, chars, SIZE, iniFile); if (bytesReturned != 0) { value = new string(chars).Split(new char[] { '\0' }, StringSplitOptions.RemoveEmptyEntries); } chars = null; return value; } /// /// 读取INI文件中指定KEY的字符串型值 /// /// Ini文件 /// 段落名称 /// 键名称 /// 如果没此KEY所使用的默认值 /// 读取到的值 public static string INIGetStringValue(string iniFile, string section, string key, string defaultValue) { string value = defaultValue; const int SIZE = 1024 * 10; if (string.IsNullOrEmpty(section)) { throw new ArgumentException("必须指定段落名称", "section"); } if (string.IsNullOrEmpty(key)) { throw new ArgumentException("必须指定键名称", "key"); } StringBuilder sb = new StringBuilder(SIZE); uint bytesReturned = GetPrivateProfileString(section, key, defaultValue, sb, SIZE, iniFile); if (bytesReturned != 0) { value = sb.ToString(); } sb = null; return value; } /// /// 在INI文件中,将指定的键值对写到指定的段落,如果已经存在则替换 /// /// INI文件 /// 段落,如果不存在此段落,则创建此段落 /// 键值对,多个用\0分隔,形如key1=value1\0key2=value2 /// public static bool INIWriteItems(string iniFile, string section, string items) { if (string.IsNullOrEmpty(section)) { throw new ArgumentException("必须指定段落名称", "section"); } if (string.IsNullOrEmpty(items)) { throw new ArgumentException("必须指定键值对", "items"); } string filePath = iniFile.Remove(iniFile.LastIndexOf("\\")); if (!Directory.Exists(filePath)) Directory.CreateDirectory(filePath); return WritePrivateProfileSection(section, items, iniFile); } /// /// 在INI文件中,指定段落写入指定的键及值。如果已经存在,则替换。如果没有则创建。 /// /// INI文件 /// 段落 /// 键 /// 值 /// 操作是否成功 public static bool INIWriteValue(string iniFile, string section, string key, string value) { if (string.IsNullOrEmpty(section)) { throw new ArgumentException("必须指定段落名称", "section"); } if (string.IsNullOrEmpty(key)) { throw new ArgumentException("必须指定键名称", "key"); } if (value == null) { throw new ArgumentException("值不能为null", "value"); } string filePath = iniFile.Remove(iniFile.LastIndexOf("\\")); if (!Directory.Exists(filePath)) Directory.CreateDirectory(filePath); return WritePrivateProfileString(section, key, value, iniFile); } /// /// 在INI文件中,删除指定段落中的指定的键。 /// /// INI文件 /// 段落 /// 键 /// 操作是否成功 public static bool INIDeleteKey(string iniFile, string section, string key) { if (string.IsNullOrEmpty(section)) { throw new ArgumentException("必须指定段落名称", "section"); } if (string.IsNullOrEmpty(key)) { throw new ArgumentException("必须指定键名称", "key"); } return WritePrivateProfileString(section, key, null, iniFile); } /// /// 在INI文件中,删除指定的段落。 /// /// INI文件 /// 段落 /// 操作是否成功 public static bool INIDeleteSection(string iniFile, string section) { if (string.IsNullOrEmpty(section)) { throw new ArgumentException("必须指定段落名称", "section"); } return WritePrivateProfileString(section, null, null, iniFile); } /// /// 在INI文件中,删除指定段落中的所有内容。 /// /// INI文件 /// 段落 /// 操作是否成功 public static bool INIEmptySection(string iniFile, string section) { if (string.IsNullOrEmpty(section)) { throw new ArgumentException("必须指定段落名称", "section"); } return WritePrivateProfileSection(section, string.Empty, iniFile); } /// /// 在INI文件中,删除所有段落 /// /// INI文件 public static bool INIDeleteAll(string iniFile) { try { string[] section = INIGetAllSectionNames(iniFile); for (int i = 0; i < section.Length; i++) { INIDeleteSection(iniFile, section[i]); } return true; } catch { return false; } } #endregion } }