（C#）CsvHelperユーザーガイド

** この記事のコードはCsvHelper 15.0.5に基づいています。

プロフィール：プロフィール

CsvHelperはCSVファイルの読み書き用の. NETライブラリです。非常に速く、柔軟で使いやすいです。

CsvHelperは. NET Standard 2.0上に構築されており、ほぼどこでも動作します。

GitHubアドレスhttps//github.com/joshclose/csvhelper

モジュールモジュール

モジュールモジュール	機能性は
CsvHelper	CSVデータを読み書きするためのコアクラス。
CsvHelper.Configuration	CsvHelperの読み書き動作を設定するクラス。
CsvHelper.Configuration.Attributes	CsvHelperの機能を設定する。
CsvHelper.Expressions	LINQ式を生成するクラス。
CsvHelper.TypeConversion	CSVフィールドを. NET型と相互変换するクラス。

Read ingとは

** テストクラス **

public class Foo
{
    public int ID { get; set; }

    public string Name { get; set; }
}

**csvファイル **

ID,Name
1,Tom
2,Jerry

すべてのレコードを読む。

using (var reader = new StreamReader("foo.csv"))
{
    using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
    {
        var records = csv.GetRecords<Foo>();
    }
}

csvファイルを読み込むとき、空白行は無視され、空白行にスペースが含まれている場合はエラーが報告されます。如果是 Excel 编辑的 CSV 文件，空行将会变成仅包含分隔符 , 的行，也会报错。

記事ごとに読む

using (var reader = new StreamReader("foo.csv"))
{
    using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
    {
        while (csv.Read())
        {
            var record = csv.GetRecord<Foo>();
        }
    }
}

GetRecords<T> 方法通过 yield 返回一个 IEnumerable<T>，并不会将内容一次全部读进内存，除非调用了 ToList 或 ToArray 方法。所以这种逐条读取的写法没有太多必要。

個々のフィールドの読み取り

using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
{
    csv.Read();
    csv.ReadHeader();

    while (csv.Read())
    {
        var id = csv.GetField<int>(0);
        var name = csv.GetField<string>("Name");
    }
}

プログレッシブリーディングではヘッダラインに関係なくできますが、ここではできません。

csv.Read(); 这句是读取标题，如果没有的话，while 循环第一次取到的是标题，肯定会报错。

csv.ReadHeader(); 这句是给标题赋值，如果没有的话，csv.GetField<string>("Name") 会报找不到标题。

使用 TryGetField 可以防止意外的报错。

csv.TryGetField(0, out int id);

Write（書き込み）

すべてのレコードを書き込む

var records = new List<Foo>
{
    new Foo { ID = 1, Name = "Tom" },
    new Foo { ID = 2, Name = "Jerry" },
};

using (var writer = new StreamWriter("foo.csv"))
{
    using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
    {
        csv.WriteRecords(records);
    }
}

箇条書きに書き込む

using (var writer = new StreamWriter("foo.csv"))
{
    using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
    {
        foreach (var record in records)
        {
            csv.WriteRecord(record);
        }
    }
}

フィールドごとの書き込み

using (var writer = new StreamWriter("foo.csv"))
{
    using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
    {
        csv.WriteHeader<Foo>();
        csv.NextRecord();

        foreach (var record in records)
        {
            csv.WriteField(record.ID);
            csv.WriteField(record.Name);
            csv.NextRecord();
        }
    }
}

プロパティ

Index

Index 特性用于标记字段顺序。

ファイルを読み込むときに、ヘッダがなければ、順序によってフィールドを特定することしかできない。

public class Foo
{
    [Index(0)]
    public int ID { get; set; }

    [Index(1)]
    public string Name { get; set; }
}

using (var reader = new StreamReader("foo.csv"))
{
    using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
    {
        csv.Configuration.HasHeaderRecord = false;

        var records = csv.GetRecords<Foo>().ToList();
    }
}

csv.Configuration.HasHeaderRecord = false 配置告知 CsvReader 没有标题。必须要加这一行，否则会默认第一行为标题而跳过，导致最后的结果中少了一行。如果数据量比较多，会很难发现这个 bug。

在写入文件的时候，会按 Index 顺序写入。如果不想写入标题，也需要添加 csv.Configuration.HasHeaderRecord = false;

Name

如果字段名称和列名不一致，可以使用 Name 属性。

public class Foo
{
    [Name("id")]
    public int ID { get; set; }

    [Name("name")]
    public string Name { get; set; }
}

NameIndex

NameIndex 用于处理 CSV 文件中的同名列。

public class Foo
{
    ...

    [Name("Name")]
    [NameIndex(0)]
    public string FirstName { get; set; }

    [Name("Name")]
    [NameIndex(1)]
    public string LastName { get; set; }
}

Ignore

フィールドを無視する

Optional

読み取り時に一致するフィールドが見つからない場合は無視されます。

public class Foo
{
    ...

    [Optional]
    public string Remarks { get; set; }
}

Default

当读取的字段为空时 Default 特性可为其指定默认值。

Default 特性仅在读取时有效，写入时是不会将空值替换为默认值写入的。

NullValues

public class Foo
{
    ...

    [NullValues("None", "none", "Null", "null")]
    public string None { get; set; }
}

读取文件时，若 CSV 文件中某字段的值为空，那么读取后的值是 ""，而非 null，标记 NullValues 特性后，若 CSV 文件中的某字段值为 NullValues 指定的值，则读取后为 null。

若同时标记了 Default 特性，则此特性不起作用。

問題は、この機能はファイルを書き込むときには機能しません。そのため読み書きの不一致の問題が発生する.

Constant

Constant 特性为字段指定一个常量值，读写时都使用此值，无论指定了什么其他映射或配置。

Format

Format 指定类型转换时使用的字符串格式。

例えば、数値型や時刻型は、しばしば形式を指定します。

public class Foo
{
    ...

    [Format("0.00")]
    public decimal Amount { get; set; }

    [Format("yyyy-MM-dd HH:mm:ss")]
    public DateTime JoinTime { get; set; }
}

Boolean FalseValuesとBoolean FalseValues

この2つの機能は、boolを指定された形式に変換するために使用される。

public class Foo
{
    ...

    [BooleanTrueValues("yes")]
    [BooleanFalseValues("no")]
    public bool Vip { get; set; }
}

NumberStyles

public class Foo
{
    ...

    [Format("X2")]
    [NumberStyles(NumberStyles.HexNumber)]
    public int Data { get; set; }
}

比较有用是 NumberStyles.HexNumber 和 NumberStyles.AllowHexSpecifier，这两个枚举的作用差不多。此特性仅在读取时有效，写入时并不会转成 16 进制写入。这会导致读写不一致，可以用 Format 特性指定写入格式。

マッピングマッピング

如果无法给要映射的类添加特性，在这种情况下，可以使用 ClassMap 方式进行映射。

マッピングと機能効果の使用は同じであり、穴の場所も同じです。以下の例では、上記の機能をプロパティで実装します。

public class Foo2
{
    public int ID { get; set; }

    public string Name { get; set; }

    public decimal Amount { get; set; }

    public DateTime JoinTime { get; set; }

    public string Msg { get; set; }

    public string Msg2 { get; set; }

    public bool Vip { get; set; }

    public string Remarks { get; set; }

    public string None { get; set; }

    public int Data { get; set; }
}

public class Foo2Map : ClassMap<Foo2>
{
    public Foo2Map()
    {
        Map(m => m.ID).Index(0).Name("id");
        Map(m => m.Name).Index(1).Name("name");
        Map(m => m.Amount).TypeConverterOption.Format("0.00");
        Map(m => m.JoinTime).TypeConverterOption.Format("yyyy-MM-dd HH:mm:ss");
        Map(m => m.Msg).Default("Hello");
        Map(m => m.Msg2).Ignore();
        Map(m => m.Vip)
            .TypeConverterOption.BooleanValues(true, true, new string[] { "yes" })
            .TypeConverterOption.BooleanValues(false, true, new string[] { "no" });
        Map(m => m.Remarks).Optional();
        Map(m => m.None).TypeConverterOption.NullValues("None", "none", "Null", "null");
        Map(m => m.Data)
            .TypeConverterOption.NumberStyles(NumberStyles.HexNumber)
            .TypeConverterOption.Format("X2");
    }
}

マッピングを使用する前に登録が必要

csv.Configuration.RegisterClassMap<Foo2Map>();

ConvertUsing

ConvertUsing 允许使用一个委托方法实现类型转换。

// 常数
Map(m => m.Constant).ConvertUsing(row => 3);

// 把两列聚合在一起
Map(m => m.Name).ConvertUsing(row => $"{row.GetField<string>("FirstName")} {row.GetField<string>("LastName")}");

Map(m => m.Names).ConvertUsing(row => new List<string> { row.GetField<string>("Name") } );

構成

Delimiter

セパレータ

csv.Configuration.Delimiter = ",";

HasHeaderRecord

この設定は前述しましたが、最初の行をタイトルにしますか？

csv.Configuration.HasHeaderRecord = false;

IgnoreBlankLines

是否忽略空行，默认 true

csv.Configuration.IgnoreBlankLines = false;

无法忽略一个仅包含空格或 , 的行。

AllowComments

是否允许注释，注释以 # 开头。

csv.Configuration.AllowComments = true;

Comment

获取或设置用于表示注释掉的行的字符。默认是 #。

csv.Configuration.Comment = '/';

BadDataFound

データが正しくない場合に起動する関数を設定します。この関数はログに使用できます。

IgnoreQuotes

引用符を無視し、構文解析時に他の文字と同じように扱うかどうかを示す値を取得または設定します。

默认是 false，如果字符串中有引号，必须是 3 个 " 连在一起，读取到的字符串中才会有一个 "，如果是 1 个则忽略，2 个则报错。

如果为 true，则会将 " 当做字符串原样返回。

csv.Configuration.IgnoreQuotes = true;

CsvWriter 中是没有这个属性的，一旦字符串中包含 "，写出来就是 3 个 " 连在一起。

TrimOptions

フィールド·エンド·スペースの除去

csv.Configuration.TrimOptions = TrimOptions.Trim;

PrepareHeaderForMatch

PrepareHeaderForMatch 定义了属性名称与标题进行匹配的函数。标题和属性名称均通过该函数运行。此功能可用于删除标题中的空格，或者当标题和属性名称大小写不一致时统一大小写后比较。

csv.Configuration.PrepareHeaderForMatch = (string header, int index) => header.ToLower();