C#操作CSV文件的详细教程_Asp.net

一、csv 格式详解

基本语法

csv 文件以纯文本形式存储数据，每一行代表一条记录。
字段之间以逗号（,）分隔，例如：姓名,年龄,性别。
如果字段中包含逗号、双引号（"）或换行符，需要用双引号将字段包围起来。如果字段本身包含双引号，则需要用两个双引号表示一个双引号。例如："张三,程序员","25","男"，其中第一个字段包含逗号，因此用双引号包围；若字段是 "o'neill"，则应写成 """o""neill"""。

编码格式

常见的 csv 文件编码有 utf - 8、gbk 等。在读写 csv 文件时，需要确保指定正确的编码格式，否则可能会出现乱码。例如，在使用 streamreader 或 streamwriter 时，可以通过 encoding 参数指定编码：

using (streamreader reader = new streamreader("data.csv", system.text.encoding.utf8))
{
    // 读取操作
}

二、读取 csv 文件的多种方式

（一）使用streamreader逐行读取

原理：通过 streamreader 逐行读取 csv 文件内容，然后对每一行进行处理，将字符串按逗号分隔成数组。

代码示例 ：

using system;
using system.collections.generic;
using system.io;

class program
{
    static void main()
    {
        list<string[]> csvdata = new list<string[]>();
        using (streamreader reader = new streamreader("data.csv"))
        {
            string line;
            while ((line = reader.readline()) != null)
            {
                // 将每一行按逗号分隔成数组
                string[] fields = line.split(',');
                csvdata.add(fields);
            }
        }
        // 输出读取的数据
        foreach (string[] row in csvdata)
        {
            foreach (string field in row)
            {
                console.write(field + "\t");
            }
            console.writeline();
        }
    }
}

优点：简单易用，适合小型 csv 文件的读取。
缺点：对于包含复杂字段（如字段中包含逗号、引号等特殊字符）的 csv 文件，无法正确解析。

（二）使用textfieldparser（需引用microsoft.visualbasic.dll组件）

原理：textfieldparser 是 .net framework 提供的一个专门用于解析文本文件的类，它可以更好地处理 csv 文件中包含特殊字符的字段。
代码示例 ：

using system;
using microsoft.visualbasic.fileio;

class program
{
    static void main()
    {
        using (textfieldparser parser = new textfieldparser("data.csv"))
        {
            parser.textfieldtype = fieldtype.delimited;
            parser.setdelimiters(",");
            while (!parser.endofdata)
            {
                try
                {
                    string[] fields = parser.readfields();
                    foreach (string field in fields)
                    {
                        console.write(field + "\t");
                    }
                    console.writeline();
                }
                catch (malformedlineexception ex)
                {
                    console.writeline("行 {0} 格式错误: {1}", parser.linenumber, ex.message);
                }
            }
        }
    }
}

优点：能够正确处理字段中包含逗号、引号等特殊字符的情况。
缺点：需要引用 microsoft.visualbasic.dll 组件。

（三）使用第三方库（如 csvhelper）

原理：csvhelper 是一个功能强大的开源 csv 操作库，它提供了更简便的 api，可以轻松地读取和写入 csv 文件，并且支持将 csv 数据映射到对象。
安装 csvhelper ：通过 nuget 包管理器安装 csvhelper，命令如下：

install-package csvhelper

代码示例 - 读取 csv 文件 ：

using system;
using system.collections.generic;
using system.io;
using csvhelper;
using csvhelper.configuration;

class program
{
    static void main()
    {
        using (streamreader reader = new streamreader("data.csv"))
        using (csvreader csv = new csvreader(reader, new csvconfiguration(system.globalization.cultureinfo.invariantculture)))
        {
            var records = csv.getrecords<person>().tolist();
            foreach (person person in records)
            {
                console.writeline($"姓名: {person.name}, 年龄: {person.age}, 性别: {person.gender}");
            }
        }
    }
}

public class person
{
    public string name { get; set; }
    public int age { get; set; }
    public string gender { get; set; }
}

优点：功能强大，易于使用，支持对象映射和高级配置。
缺点：需要引入外部依赖。

三、写入 csv 文件的多种方式

（一）使用streamwriter写入

原理：将二维数据数组或列表转换为字符串，按行写入到 csv 文件中。
代码示例 ：

using system;
using system.io;

class program
{
    static void main()
    {
        string[][] data = new string[][]
        {
            new string[] {"姓名", "年龄", "性别"},
            new string[] {"张三", "25", "男"},
            new string[] {"李四", "30", "女"}
        };
        using (streamwriter writer = new streamwriter("data.csv"))
        {
            foreach (string[] row in data)
            {
                // 将数组元素用逗号连接成一行
                writer.writeline(string.join(",", row));
            }
        }
    }
}

优点：简单易用，适合小型 csv 文件的写入。
缺点：无法自动处理字段中的特殊字符。

（二）使用stringbuilder构建内容后写入

原理：先用 stringbuilder 构建整个 csv 内容，最后一次性写入文件，减少文件操作次数，尤其适用于大量数据写入。
代码示例 ：

using system;
using system.io;
using system.text;

class program
{
    static void main()
    {
        string[][] data = new string[][]
        {
            new string[] {"姓名", "年龄", "性别"},
            new string[] {"张三", "25", "男"},
            new string[] {"李四", "30", "女"}
        };
        stringbuilder sb = new stringbuilder();
        foreach (string[] row in data)
        {
            sb.appendline(string.join(",", row));
        }
        file.writealltext("data.csv", sb.tostring());
    }
}

优点：提高写入效率，适合大量数据写入。
缺点：无法自动处理字段中的特殊字符。

（三）使用第三方库（如 csvhelper）写入

原理：利用 csvhelper 提供的简便 api，将对象列表写入 csv 文件，自动处理字段中的特殊字符。
代码示例 ：

using system;
using system.collections.generic;
using system.io;
using csvhelper;

class program
{
    static void main()
    {
        list<person> persons = new list<person>
        {
            new person { name = "张三", age = 25, gender = "男" },
            new person { name = "李四", age = 30, gender = "女" }
        };
        using (streamwriter writer = new streamwriter("data.csv"))
        using (csvwriter csv = new csvwriter(writer, system.globalization.cultureinfo.invariantculture))
        {
            csv.writerecords(persons);
        }
    }
}

public class person
{
    public string name { get; set; }
    public int age { get; set; }
    public string gender { get; set; }
}

优点：功能强大，易于使用，自动处理特殊字符。
缺点：需要引入外部依赖。

四、csv 数据的解析与处理

（一）处理字段中的特殊字符

引号包围字段 ：如果字段中包含逗号、引号或换行符，需要用双引号将字段包围起来。如果字段本身包含双引号，则需要用两个双引号表示一个双引号。
代码示例 - 写入包含特殊字符的字段 ：

using system;
using system.io;

class program
{
    static void main()
    {
        string[][] data = new string[][]
        {
            new string[] {"姓名", "年龄", "爱好"},
            new string[] {"张三", "25", "读书, 旅行"},
            new string[] {"李四", "30", "打篮球\" \"排球"}
        };
        using (streamwriter writer = new streamwriter("data.csv"))
        {
            foreach (string[] row in data)
            {
                for (int i = 0; i < row.length; i++)
                {
                    // 如果字段中包含逗号、引号或换行符，用双引号包围
                    if (row[i].contains(",") || row[i].contains("\"") || row[i].contains("\n") || row[i].contains("\r"))
                    {
                        // 将字段中的双引号替换为两个双引号
                        row[i] = "\"" + row[i].replace("\"", "\"\"") + "\"";
                    }
                    writer.write(row[i]);
                    if (i < row.length - 1)
                    {
                        writer.write(",");
                    }
                }
                writer.writeline();
            }
        }
    }
}

（二）将 csv 数据映射到对象

定义数据类 ：根据 csv 文件的结构定义一个对应的类，方便对数据进行操作。
代码示例 ：

using system;
using system.collections.generic;
using system.io;

class program
{
    static void main()
    {
        list<person> persons = new list<person>();
        using (streamreader reader = new streamreader("data.csv"))
        {
            // 跳过标题行
            reader.readline();
            string line;
            while ((line = reader.readline()) != null)
            {
                string[] fields = line.split(',');
                person person = new person
                {
                    name = fields[0],
                    age = int.parse(fields[1]),
                    gender = fields[2]
                };
                persons.add(person);
            }
        }
        // 输出对象数据
        foreach (person person in persons)
        {
            console.writeline($"姓名: {person.name}, 年龄: {person.age}, 性别: {person.gender}");
        }
    }
}

public class person
{
    public string name { get; set; }
    public int age { get; set; }
    public string gender { get; set; }
}

五、注意事项

文件路径问题

确保提供的文件路径正确。如果文件不存在，读取操作会抛出异常；如果写入路径无效，可能会导致写入失败或创建新文件在错误的位置。
可以使用 file.exists 方法检查文件是否存在：

if (!file.exists("data.csv"))
{
    console.writeline("文件不存在！");
}

数据类型转换问题

在将 csv 数据转换为对象属性时，要注意数据类型的正确转换。如果转换失败，可能会引发异常，如将字符串转换为整数时，字符串不是有效的整数格式。
可以使用 tryparse 方法进行安全转换：

int age;
if (int.tryparse(fields[1], out age))
{
    person.age = age;
}
else
{
    console.writeline("年龄数据格式错误！");
}

性能优化

对于大型 csv 文件的读写操作，可以考虑使用流式处理，避免一次性加载整个文件到内存中。例如，使用 streamreader 逐行读取，或使用 streamwriter 逐行写入。
如果需要频繁读写 csv 文件，可以考虑使用内存映射文件（memory - mapped files）技术提高性能。

以上就是c#操作csv文件的详细教程的详细内容，更多关于c#操作csv文件的资料请关注代码网其它相关文章！