namespace apimethod
{
/*
* 姓名：谭义
* 时间：2008.5.28
* q q：260511433
* msn ：luoye0732@hotmail.com
* 邮箱：luoye0732@163.com
* 备注：假如大家对此模块还需要补充或完善修改的，请和我联系，大家一起努力。
* 注重：此模块只能获得一个键的值，假如谁能完善获得一个小节的所有键与值，请与我联系。
*/
/// <summary>
/// ini文件操作类
/// </summary>
public sealed class iniutility
{
private static string _filepath = string.empty;//文件路径
/// <summary>
/// 文件路径
/// </summary>
public static string filepath
{
get { return _filepath; }
set { _filepath = value; }
}
/// <summary>
/// windows api 对ini文件写方法
/// </summary>
/// <param name="lpapplicationname">要在其中写入新字串的小节名称。这个字串不区分大小写</param>
/// <param name="lpkeyname">要设置的项名或条目名。这个字串不区分大小写。用null可删除这个小节的所有设置项</param>
/// <param name="lpstring">指定为这个项写入的字串值。用null表示删除这个项现有的字串</param>
/// <param name="lpfilename">初始化文件的名字。假如没有指定完整路径名，则windows会在windows目录查找文件。假如文件没有找到，则函数会创建它</param>
/// <returns></returns>
[system.runtime.interopservices.dllimport("kernel32")]
private static extern long writeprivateprofilestring(string lpapplicationname, string lpkeyname, string lpstring, string lpfilename);
/// <summary>
/// windows api 对ini文件读方法
/// </summary>
/// <param name="lpapplicationname">欲在其中查找条目的小节名称。这个字串不区分大小写。如设为null，就在lpreturnedstring缓冲区内装载这个ini文件所有小节的列表</param>
/// <param name="lpkeyname">欲获得的项名或条目名。这个字串不区分大小写。如设为null，就在lpreturnedstring缓冲区内装载指定小节所有项的列表</param>
/// <param name="lpdefault">指定的条目没有找到时返回的默认值。可设为空（""）</param>
/// <param name="lpreturnedstring">指定一个字串缓冲区，长度至少为nsize</param>
/// <param name="nsize">指定装载到lpreturnedstring缓冲区的最大字符数量</param>
/// <param name="lpfilename">初始化文件的名字。如没有指定一个完整路径名，windows就在windows目录中查找文件</param>
/// 注重：如lpkeyname参数为null，那么lpreturnedstring缓冲区会载入指定小节所有设置项的一个列表。
/// 每个项都用一个null字符分隔，最后一个项用两个null字符中止。也请参考getprivateprofileint函数的注解
/// <returns></returns>
[system.runtime.interopservices.dllimport("kernel32")]
private static extern long getprivateprofilestring(string lpapplicationname, string lpkeyname, string lpdefault, system.text.stringbuilder lpreturnedstring, int nsize, string lpfilename);
/// <summary>
/// 向ini文件中写入值
/// </summary>
/// <param name="section">小节的名称</param>
/// <param name="key">键的名称</param>
/// <param name="value">键的值</param>
/// <returns>执行成功为true，失败为false。</returns>
public static long writeinikey(string section, string key, string value)
{
if (section.trim().length <= 0 || key.trim().length <= 0 ||
value.trim().length <= 0) return 0;
return writeprivateprofilestring(section, key, value, filepath);
}
/// <summary>
/// 删除指定小节中的键
/// </summary>
/// <param name="section">小节的名称</param>
/// <param name="key">键的名称</param>
/// <returns>执行成功为true，失败为false。</returns>
public static long deleteinikey(string section, string key)
{
if (section.trim().length <= 0 || key.trim().length <= 0) return 0;
return writeprivateprofilestring(section, key, null, filepath);
}
/// <summary>
/// 删除指定的小节（包括这个小节中所有的键）
/// </summary>
/// <param name="section">小节的名称</param>
/// <returns>执行成功为true，失败为false。</returns>
public static long deleteinisection(string section)
{
if (section.trim().length <= 0) return 0;
return writeprivateprofilestring(section, null, null, filepath);
}
/// <summary>
/// 获得指定小节中键的值
/// </summary>
/// <param name="section">小节的名称</param>
/// <param name="key">键的名称</param>
/// <param name="defaultvalue">假如键值为空，或没找到，返回指定的默认值。</param>
/// <param name="capacity">缓冲区初始化大小。</param>
/// <returns>键的值</returns>
public static string getinikeyvalue(string section, string key,string defaultvalue,int capacity)
{
if (section.trim().length <= 0 || key.trim().length <= 0) return defaultvalue;
system.text.stringbuilder strtemp = new system.text.stringbuilder(capacity);
long returnvalue = getprivateprofilestring(section, key, defaultvalue, strtemp, capacity, filepath);
return strtemp.tostring().trim();
}
/// <summary>
/// 获得指定小节中键的值
/// </summary>
/// <param name="section">小节的名称</param>
/// <param name="key">键的名称</param>
/// <param name="defaultvalue">假如键值为空，或没找到，返回指定的默认值。</param>
/// <returns>键的值</returns>
public static string getinikeyvalue(string section, string key, string defaultvalue)
{
return getinikeyvalue(section, key, defaultvalue, 1024);
}
/// <summary>
/// 获得指定小节中键的值
/// </summary>
/// <param name="section">小节的名称</param>
/// <param name="key">键的名称</param>
/// <returns>键的值</returns>
public static string getinikeyvalue(string section, string key)
{
return getinikeyvalue(section, key, string.empty, 1024);
}
}
}
