C#实现读写CSV文件的方法详解-C#/.NET开发

项目中经常遇到CSV文件的读写需求，其中的难点主要是CSV文件的解析。本文会介绍CsvHelper、TextFieldParser、正则表达式三种解析CSV文件的方法，需要的可以参考一下

CSV文件标准

在介绍CSV文件的读写方法前，我们需要了解一下CSV文件的格式。

文件示例

一个简单的CSV文件：

Test1,Test2,Test3,Test4,Test5,Test6
str1,str2,str3,str4,str5,str6
str1,str2,str3,str4,str5,str6

一个不简单的CSV文件：

"Test1
"",""","Test2
"",""","Test3
"",""","Test4
"",""","Test5
"",""","Test6
"","""
" 中文,D23 ","3DFD4234""""""1232""1S2","ASD1"",""23,,,,213
23F32","
",,asd
" 中文,D23 ","3DFD4234""""""1232""1S2","ASD1"",""23,,,,213
23F32","
",,asd

你没看错，上面两个都是CSV文件，都只有3行CSV数据。第二个文件多看一眼都是精神污染，但项目中无法避免会出现这种文件。

RFC 4180

CSV文件没有官方的标准，但一般项目都会遵守 RFC 4180 标准。这是一个非官方的标准，内容如下：

Each record is located on a separate line, delimited by a line break (CRLF).

The last record in the file may or may not have an ending line break.

There maybe an optional header line appearing as the first line of the file with the same format as normal record lines. This header will contain names corresponding to the fields in the file and should contain the same number of fields as the records in the rest of the file (the presence or absence of the header line should be indicated via the optional "header" parameter of this MIME type).

Within the header and each record, there may be one or more fields, separated by commas. Each line should contain the same number of fields throughout the file. Spaces are considered part of a field and should not be ignored. The last field in the record must not be followed by a comma.

Each field may or may not be enclosed in double quotes (however some programs, such as Microsoft Excel, do not use double quotes at all). If fields are not enclosed with double quotes, then double quotes may not appear inside the fields.

Fields containing line breaks (CRLF), double quotes, and commas should be enclosed in double-quotes.

If double-quotes are used to enclose fields, then a double-quote appearing inside a field must be escaped by preceding it with another double quote.

翻译一下：

每条记录位于单独的行上，由换行符 (CRLF) 分隔。
文件中的最后一条记录可能有也可能没有结束换行符。
可能有一个可选的标题行出现在文件的第一行，格式与普通记录行相同。此标题将包含与文件中的字段对应的名称，并且应包含与文件其余部分中的记录相同数量的字段（标题行的存在或不存在应通过此 MIME 类型的可选“标头”参数指示）。
在标题和每条记录中，可能有一个或多个字段，以逗号分隔。在整个文件中，每行应包含相同数量的字段。空格被视为字段的一部分，不应忽略。记录中的最后一个字段后面不能有逗号。
每个字段可以用双引号括起来，也可以不用双引号（但是某些程序，例如 Microsoft Excel，根本不使用双引号）。如果字段没有用双引号括起来，那么双引号可能不会出现在字段内。
包含换行符 (CRLF)、双引号和逗号的字段应该用双引号括起来。
如果使用双引号将字段括起来，则出现在字段中的双引号必须在其前面加上另一个双引号。

简化标准

上面的标准可能比较拗口，我们对它进行一些简化。要注意一下，简化不是简单的删减规则，而是将类似的类似进行合并便于理解。
后面的代码也会使用简化标准，简化标准如下：

每条记录位于单独的行上，由换行符 (CRLF) 分隔。
注：此处的行不是普通文本意义上的行，是指符合CSV文件格式的一条记录（后面简称为CSV行），在文本上可能占据多行。
文件中的最后一条记录需有结束换行符，文件的第一行为标题行（标题行包含字段对应的名称，标题数与记录的字段数相同）。
注：原标准中可有可无的选项统一规定为必须有，方便后期的解析，而且没有标题行让别人怎么看数据。
在标题和每条记录中，可能有一个或多个字段，以逗号分隔。在整个文件中，每行应包含相同数量的字段。空格被视为字段的一部分，不应忽略。记录中的最后一个字段后面不能有逗号。
注：此标准未做简化，虽然也有其它标准使用空格、制表符等做分割的，但不使用逗号分割的文件还叫逗号分隔值文件吗。
每个字段都用双引号括起来，出现在字段中的双引号必须在其前面加上另一个双引号
注：原标准有必须使用双引号和可选双引号的情况，那全部使用双引号肯定不会出错。*

读写CSV文件

在正式读写CSV文件前，我们需要先定义一个用于测试的Test类。代码如下：

class Test
{
    public string Test1{get;set;}
    public string Test2 { get; set; }
    public string Test3 { get; set; }
    public string Test4 { get; set; }
    public string Test5 { get; set; }
    public string Test6 { get; set; }

    //Parse方法会在自定义读写CSV文件时用到
    public static Test Parse (string[]fields )
    {
        try
        {
            Test ret = new Test();
            ret.Test1 = fields[0];
            ret.Test2 = fields[1];
            ret.Test3 = fields[2];
            ret.Test4 = fields[3];
            ret.Test5 = fields[4];
            ret.Test6 = fields[5];
            return ret;
        }
        catch (Exception)
        {
            //做一些异常处理，写日志之类的
            return null;
        }
    }
}

生成一些测试数据，代码如下：

static void Main(string[] args)
{
    //文件保存路径
    string path = "tset.csv";
    //清理之前的测试文件
    File.Delete("tset.csv");
      
    Test test = new Test();
    test.Test1 = " 中文,D23 ";
    test.Test2 = "3DFD4234\"\"\"1232\"1S2";
    test.Test3 = "ASD1\",\"23,,,,213\r23F32";
    test.Test4 = "\r";
    test.Test5 = string.Empty;
    test.Test6 = "asd";

    //测试数据
    var records = new List<Test> { test, test };

    //写CSV文件
    /*
    *直接把后面的写CSV文件代码复制到此处
    */

    //读CSV文件
     /*
    *直接把后面的读CSV文件代码复制到此处
    */
   
    Console.ReadLine();
}

使用CsvHelper

CsvHelper 是用于读取和写入 CSV 文件的库，支持自定义类对象的读写。

github上标星最高的CSV文件读写C#库，使用MS-PL、Apache 2.0开源协议。

使用NuGet下载CsvHelper，读写CSV文件的代码如下：

 //写CSV文件
using (var writer = new StreamWriter(path))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    csv.WriteRecords(records);
}

using (var writer = new StreamWriter(path,true))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
    //追加
    foreach (var record in records)
    {
        csv.WriteRecord(record);
    }
}

//读CSV文件
using (var reader = new StreamReader(path))
using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
{
    records = csv.GetRecords<Test>().ToList();
    //逐行读取
    //records.Add(csv.GetRecord<Test>());
}

如果你只想要拿来就能用的库，那文章基本上到这里就结束了。

使用自定义方法

为了与CsvHelper区分，新建一个CsvFile类存放自定义读写CSV文件的代码，最后会提供类的完整源码。CsvFile类定义如下：

/// <summary>
/// CSV文件读写工具类
/// </summary>
public class CsvFile
{
    #region 写CSV文件
    //具体代码...
    #endregion

    #region 读CSV文件（使用TextFieldParser）
    //具体代码...
    #endregion

    #region 读CSV文件（使用正则表达式）
    //具体代码...
    #endregion

}

基于简化标准的写CSV文件

根据简化标准（具体标准内容见前文），写CSV文件代码如下：

#region 写CSV文件
//字段数组转为CSV记录行
private static string FieldsToLine(IEnumerable<string> fields)
{
    if (fields == null) return string.Empty;
    fields = fields.Select(field =>
    {
        if (field == null) field = string.Empty;
        //简化标准，所有字段都加双引号
        field = string.Format("\"{0}\"", field.Replace("\"", "\"\""));

        //不简化标准
        //field = field.Replace("\"", "\"\"");
        //if (field.IndexOfAny(new char[] { ',', '"', ' ', '\r' }) != -1)
        //{
        //    field = string.Format("\"{0}\"", field);
        /

C#实现读写CSV文件的方法详解

目录