欢迎来到尧图网

客户服务 关于我们

您的位置:首页 > 健康 > 美食 > 在C#中配置ini文件以及封装ini类

在C#中配置ini文件以及封装ini类

2025/6/30 19:40:22 来源:https://blog.csdn.net/weixin_64532720/article/details/140999796  浏览:    关键词:在C#中配置ini文件以及封装ini类

在C#中使用 DllImport 属性从 kernel32.dll 导入函数来写入和读取Windows的INI文件,你可以使用 WritePrivateProfileString 来写入数据,使用 GetPrivateProfileString 来读取数据。

以下是如何使用这些函数的示例:

写入INI文件

using System;
using System.Runtime.InteropServices;
using System.Text;
​
class Program
{[DllImport("kernel32.dll", CharSet = CharSet.Unicode)]private static extern bool WritePrivateProfileString(string section, string key, string value, string filePath);
​static void Main(){string iniFilePath = "example.ini"; // INI文件的路径string section = "Settings"; // 节名称string key = "Resolution"; // 键名称string value = "1920x1080"; // 值
​// 调用WritePrivateProfileString函数写入INI文件bool result = WritePrivateProfileString(section, key, value, iniFilePath);
​if (result){Console.WriteLine("Write to INI file succeeded.");}else{Console.WriteLine("Write to INI file failed.");}}
}

读取INI文件

using System;
using System.Runtime.InteropServices;
​
class Program
{[DllImport("kernel32.dll", CharSet = CharSet.Unicode)]private static extern uint GetPrivateProfileString(string section, string key, string defaultValue, StringBuilder retVal, uint size, string filePath);
​static void Main(){string iniFilePath = "example.ini"; // INI文件的路径string section = "Settings"; // 节名称string key = "Resolution"; // 键名称
​StringBuilder value = new StringBuilder(255); // 假设值的最大长度为255uint bytesRead = GetPrivateProfileString(section, key, "", value, (uint)value.Capacity, iniFilePath);
​if (bytesRead > 0){Console.WriteLine($"Value read from INI file: {value.ToString()}");}else{Console.WriteLine("Value not found in INI file.");}}
}

注意事项:

  1. 字符集WritePrivateProfileStringGetPrivateProfileString 函数都有ANSI和Unicode版本。示例中使用的是Unicode版本(CharSet.Unicode),适用于需要处理Unicode字符的情况。如果你的应用只处理ANSI字符,可以使用 CharSet.Ansi

  2. 返回值GetPrivateProfileString 返回读取的字节数(不包括null终止符)。如果返回值为0,可能表示键或节不存在,或者发生了错误。

  3. 默认值GetPrivateProfileString 的第三个参数是defaultValue,当指定的键不存在时,将返回这个默认值。

  4. 安全性:使用这些函数时,需要确保传递给它们的大小参数足够大,以避免缓冲区溢出。

  5. 错误处理:如果写入或读取失败,可以通过调用 Marshal.GetLastWin32Error() 来获取错误代码。

  6. 文件存在:在使用 WritePrivateProfileStringGetPrivateProfileString 之前,确保INI文件已经存在。如果文件不存在,写入操作可能会失败。

WritePrivateProfileString是什么

WritePrivateProfileString 是一个Windows API函数,它允许你向一个INI文件中写入数据。INI文件是一种简单的文本文件,用于存储配置数据,通常由应用程序用来存储用户设置和程序参数。

这个函数的原型如下(在Windows API文档或头文件中):

BOOL WritePrivateProfileString(LPCSTR lpAppName, LPCSTR lpKeyName, LPCSTR lpString, LPCSTR lpFileName
);

参数说明:

  • lpAppName: 指向一个以null结尾的字符串,指定节的名称。如果这个节不存在,函数将创建它。如果这个参数是 NULL,则指定的键将被写入到INI文件的全局区域(即不在任何节中)。

  • lpKeyName: 指向一个以null结尾的字符串,指定要写入的键的名称。如果这个键不存在,函数将创建它。如果这个参数是 NULL,则指定的节(lpAppName)将被删除。

  • lpString: 指向一个以null结尾的字符串,指定要写入的值。如果这个参数是 NULL,则指定的键将被删除。

  • lpFileName: 指向一个以null结尾的字符串,指定INI文件的路径。

函数返回值:

  • 如果函数成功,返回值是 TRUE

  • 如果函数失败,返回值是 FALSE。可以通过调用 GetLastError 函数来获取更多错误信息。

使用 WritePrivateProfileString 函数时,需要注意以下几点:

  • 函数使用ANSI编码,如果你的应用程序使用Unicode字符,可能需要使用 WritePrivateProfileStringW,这是 WritePrivateProfileString 的宽字符版本。

  • 函数在写入时不会自动创建文件,如果指定的INI文件不存在,函数将失败。

  • 函数在写入时会覆盖同名的节或键的现有值

GetPrivateProfileString是什么

GetPrivateProfileString 是一个Windows API函数,用于从INI文件中读取配置信息。INI文件是一种包含配置数据的文本文件,通常由应用程序用来存储用户设置和程序参数。这个函数允许你读取INI文件中的特定节(section)和键(key)的值。

函数的原型如下:

DWORD GetPrivateProfileString(LPCSTR lpAppName, LPCSTR lpKeyName, LPCSTR lpDefault, LPSTR lpReturnedString, DWORD nSize, LPCSTR lpFileName
);

参数说明:

  • lpAppName: 指向一个以null结尾的字符串,指定要读取的节的名称。如果指定了节名称,函数将只搜索该节。

  • lpKeyName: 指向一个以null结尾的字符串,指定要读取的键的名称。如果指定了键名称,函数将只读取该键的值。

  • lpDefault: 指向一个以null结尾的字符串,指定如果指定的节或键不存在时返回的默认值。

  • lpReturnedString: 指向一个缓冲区,用于接收读取的字符串。

  • nSize: 指定 lpReturnedString 缓冲区的大小(以字符为单位,包括null终止符)。

  • lpFileName: 指向一个以null结尾的字符串,指定INI文件的路径。

函数返回值:

  • 成功时,返回写入 lpReturnedString 缓冲区的字符数,不包括null终止符。

  • 如果失败,返回0。失败可能是由于文件不存在、读取错误或指定的节或键不存在。

在C#中,你可以使用 DllImport 属性来导入这个函数,并使用它来读取INI文件的内容。例如:

[DllImport("kernel32.dll", CharSet = CharSet.Ansi)]
private static extern uint GetPrivateProfileString(string lpAppName,string lpKeyName,string lpDefault,StringBuilder lpReturnedString,uint nSize,string lpFileName);

然后,你可以创建一个 StringBuilder 实例并指定一个足够大的容量来接收INI文件中的字符串。调用函数后,StringBuilder 将包含读取的值。

INI读写封装

using System;
using System.Runtime.InteropServices;
using System.Text;
​
public class IniFile
{// 定义INI文件的路径private string filePath;
​// 构造函数public IniFile(string iniFilePath){this.filePath = iniFilePath;}
​// 导入GetPrivateProfileString函数[DllImport("kernel32.dll", CharSet = CharSet.Unicode)]private static extern uint GetPrivateProfileString(string lpAppName,string lpKeyName,string lpDefault,StringBuilder lpReturnedString,uint nSize,string lpFileName);
​// 导入WritePrivateProfileString函数[DllImport("kernel32.dll", CharSet = CharSet.Unicode)]private static extern bool WritePrivateProfileString(string lpAppName,string lpKeyName,string lpString,string lpFileName);
​// 读取INI文件中的值public string ReadString(string section, string key, string defaultValue){StringBuilder stringBuilder = new StringBuilder(255);GetPrivateProfileString(section, key, defaultValue, stringBuilder, 255, filePath);return stringBuilder.ToString();}
​// 写入INI文件public void WriteString(string section, string key, string value){WritePrivateProfileString(section, key, value, filePath);}
​// 读取INI文件中的整数值public int ReadInt(string section, string key, int defaultValue){string value = ReadString(section, key, defaultValue.ToString());return int.TryParse(value, out int result) ? result : defaultValue;}
​// 写入INI文件的整数值public void WriteInt(string section, string key, int value){WritePrivateProfileString(section, key, value.ToString(), filePath);}
}
​
class Program
{static void Main(){// 指定INI文件路径string iniFilePath = "config.ini";
​// 创建IniFile对象IniFile iniFile = new IniFile(iniFilePath);
​// 写入字符串iniFile.WriteString("Settings", "Username", "user123");iniFile.WriteString("Settings", "Theme", "Dark");
​// 读取字符串string username = iniFile.ReadString("Settings", "Username", "defaultUser");string theme = iniFile.ReadString("Settings", "Theme", "Light");
​Console.WriteLine($"Username: {username}");Console.WriteLine($"Theme: {theme}");
​// 写入整数值iniFile.WriteInt("Settings", "Volume", 70);
​// 读取整数值int volume = iniFile.ReadInt("Settings", "Volume", 50);Console.WriteLine($"Volume: {volume}");}
}

这个封装提供了基本的读写功能,包括:

  • ReadString:读取INI文件中的字符串值。

  • WriteString:写入INI文件的字符串值。

  • ReadInt:读取INI文件中的整数值,如果读取失败,返回默认值。

  • WriteInt:写入INI文件的整数值。

请注意,这个封装示例使用了Unicode字符集(CharSet.Unicode),适用于处理Unicode字符串。如果你的应用只处理ANSI字符,可以使用 CharSet.Ansi

版权声明:

本网仅为发布的内容提供存储空间,不对发表、转载的内容提供任何形式的保证。凡本网注明“来源:XXX网络”的作品,均转载自其它媒体,著作权归作者所有,商业转载请联系作者获得授权,非商业转载请注明出处。

我们尊重并感谢每一位作者,均已注明文章来源和作者。如因作品内容、版权或其它问题,请及时与我们联系,联系邮箱:809451989@qq.com,投稿邮箱:809451989@qq.com

热搜词