C#实现利用Windows API读写INI文件的方法

下面是“C#实现利用Windows API读写INI文件的方法”的完整攻略：

1. INI文件是什么？

INI文件，全称为Initialization File，即初始化文件。是一种常用的配置文件，常被用于存储程序的配置信息和相关参数。INI文件通常包含了多个节(section)，每个节又包含多个键值对(key-value pairs)，节和键值对之间使用大于号（>）或者小于号（<）括起来。

INI文件的格式：

[Section1]
key1=value1
key2=value2

[Section2]
key3=value3
key4=value4

2. 在C#中使用Windows API操作INI文件

在C#中，我们可以使用Windows API来操作INI文件，具体步骤如下：

（1）声明Win32 API函数

移植Windows API函数需要使用DllImport语句，例如：

[DllImport("kernel32.dll")]
private static extern long WritePrivateProfileString(string section, string key, string value, string filePath);

[DllImport("kernel32.dll")]
private static extern int GetPrivateProfileString(string section, string key, string defaultValue, StringBuilder retVal, int size, string filePath);

以上代码中，DllImport是用于告诉编译器导入的DLL，并指出调用的函数。函数的参数和返回值类型需要跟Windows API一致。

（2）写INI文件

示例代码：

string fileName = "D:\\temp\\test.ini";
string section = "Section1";
string key = "Key1";
string value = "Value1";

WritePrivateProfileString(section, key, value, fileName);

以上代码中，我们调用了WritePrivateProfileString函数来写INI文件。参数section、key、value分别代表写入的节、键和值，fileName代表INI文件的路径。

（3）读INI文件

示例代码：

string fileName = "D:\\temp\\test.ini";
string section = "Section1";
string key = "Key1";
int size = 255;
StringBuilder sb = new StringBuilder(size);
string defaultValue = "";

GetPrivateProfileString(section, key, defaultValue, sb, size, fileName);
string value = sb.ToString();

以上代码中，我们调用了GetPrivateProfileString函数来读INI文件。参数section、key、defaultValue分别代表读取的节、键和默认值，sb代表存储返回值的StringBuilder，size代表StringBuilder的大小，fileName代表INI文件的路径。

3. 案例演示

为了更好的理解如何使用Windows API读写INI文件，我们来看一个案例：

创建一个控制台程序，输入INI文件的路径、节名、键和值。如果文件不存在，则创建文件；如果存在，则修改文件。另外，我们还可以输入任意个键值对，以及选择是否显示INI文件的内容。

示例代码：

using System;
using System.Runtime.InteropServices;
using System.Text;

namespace INIFile
{
    class Program
    {
        [DllImport("kernel32.dll")]
        private static extern long WritePrivateProfileString(string section, string key, string value, string filePath);

        [DllImport("kernel32.dll")]
        private static extern int GetPrivateProfileString(string section, string key, string defaultValue, StringBuilder retVal, int size, string filePath);

        static void Main(string[] args)
        {
            Console.Write("请输入INI文件路径：");
            string fileName = Console.ReadLine();

            Console.Write("请输入节名：");
            string section = Console.ReadLine();

            Console.Write("请输入键名：");
            string key = Console.ReadLine();

            Console.Write("请输入键值：");
            string value = Console.ReadLine();

            WritePrivateProfileString(section, key, value, fileName);

            Console.Write("是否添加任意个键值对？(Y/N)");
            string add = Console.ReadLine().ToUpper();

            while (add == "Y")
            {
                Console.Write("请输入键名：");
                string addKey = Console.ReadLine();

                Console.Write("请输入键值：");
                string addValue = Console.ReadLine();

                WritePrivateProfileString(section, addKey, addValue, fileName);

                Console.Write("继续添加？(Y/N)");
                add = Console.ReadLine().ToUpper();
            }

            Console.Write("是否显示INI文件内容？(Y/N)");
            string view = Console.ReadLine().ToUpper();

            if (view == "Y")
            {
                int size = 255;
                StringBuilder sb = new StringBuilder(size);
                string defaultValue = "";

                GetPrivateProfileString(section, key, defaultValue, sb, size, fileName);
                string displayValue = sb.ToString();

                Console.WriteLine("{0}={1}", key, displayValue);

                int len = GetPrivateProfileString(section, null, defaultValue, sb, size, fileName);

                Console.WriteLine("本节共有键值对：{0}", len - 1);

                string[] keyArray = sb.ToString().Split('\0');

                foreach (string k in keyArray)
                {
                    if (k != "")
                    {
                        GetPrivateProfileString(section, k, defaultValue, sb, size, fileName);
                        string v = sb.ToString();

                        Console.WriteLine("{0}={1}", k, v);
                    }
                }
            }

            Console.ReadKey();
        }
    }
}

在上述代码中，我们使用Console.ReadLine()方法来获取用户的输入。WritePrivateProfileString函数用于写入INI文件，GetPrivateProfileString函数用于读取INI文件。取得用户输入后，我们通过调用WritePrivateProfileString函数把键值对写入INI文件。接下来，我们询问是否添加任意个键值对，如果用户选择“是”，则继续添加；否则，跳过。最后，我们询问是否显示INI文件的内容，如果选择“是”，则获取INI文件的内容并显示。

输入测试：

请输入INI文件路径：D:\temp\test.ini
请输入节名：Section1
请输入键名：Key1
请输入键值：Hello
是否添加任意个键值对？(Y/N)Y
请输入键名：Key2
请输入键值：World
继续添加？(Y/N)N
是否显示INI文件内容？(Y/N)Y
Key1=Hello
本节共有键值对：2
Key1=Hello
Key2=World

4. 总结

以上就是利用Windows API读写INI文件的方法，其中包含了两个示例代码。INI文件是一种非常重要的文件格式，可以方便地存储程序的配置信息和相关参数。在C#中，我们可以使用Windows API来读写INI文件，这样可以简化代码，并提高程序的效率。如果你对INI文件进行操作时遇到问题，可以参考上述代码和说明。