【C# .NET8対応】改行・カンマを含むCSVを正しく読み込む2つの方法（TextFieldParser / CsvHelper）

2025年7月30日

CSVファイルをC#で読み込むとき、「カンマ」「改行」「ダブルクオート」などに苦しんだ経験はありませんか？

この記事では、特に.NET 8 環境で改行やカンマを含む複雑なCSVを正しく読み込む2つの方法を紹介します。

• ✔ TextFieldParser を使った.NET標準の方法
• ✔ 高機能な人気ライブラリ CsvHelper を使った方法

どちらもLINQと組み合わせて使えるので、後処理や検索もスマートに行えます。

✅ よくあるCSVの問題

例えば、次のようなCSVファイルを処理する場合：

NUM,SECTION,NAME,VALUE
1,"営業",山田,"売上1000"
2,"営業,
開発",田中,"売上500, 開発300"
3,"デザイン,開発",鈴木,"デザイン200, 開発400"
    

この中には…

• "デザイン,開発"：カンマを含む値
• "営業,\n開発"：改行を含む値

があり、単純な string.Split(',') では正しく処理できません。

方法①：TextFieldParser を使う（.NET 標準）

TextFieldParser は、Microsoft.VisualBasic 名前空間に含まれるクラスで、カンマ区切り + ダブルクオート対応 + 改行対応 が可能。

✔ サンプルコード

using Microsoft.VisualBasic.FileIO; // NuGet: Microsoft.VisualBasic

class CsvRecord
{
    public int NUM { get; set; }
    public string SECTION { get; set; }
    public string NAME { get; set; }
    public string VALUE { get; set; }
}

var records = new List<CsvRecord>();

using var parser = new TextFieldParser("sample.csv");
parser.TextFieldType = FieldType.Delimited;
parser.SetDelimiters(",");
parser.HasFieldsEnclosedInQuotes = true;

// ヘッダーをスキップ
parser.ReadLine();

while (!parser.EndOfData)
{
    var fields = parser.ReadFields();
    if (fields.Length >= 5)
    {
        records.Add(new CsvRecord
        {
            NUM = int.Parse(fields[0]),
            SECTION = fields[1],
            NAME = fields[2],
            VALUE = fields[3]
        });
    }
}
    

✔ 特徴

方法②：CsvHelper ライブラリを使う（推奨）

CsvHelper は、.NETで最も人気のあるCSV読み書きライブラリで、改行・カンマ・クォートなどすべてに対応済み。

✔ インストール

dotnet add package CsvHelper
    

✔ サンプルコード（自動マッピング）

using CsvHelper;
using System.Globalization;

class CsvRecord
{
    public int NUM { get; set; }
    public string SECTION { get; set; }
    public string NAME { get; set; }
    public string VALUE { get; set; }
}

using var reader = new StreamReader("sample.csv");
using var csv = new CsvReader(reader, CultureInfo.InvariantCulture);
var records = csv.GetRecords<CsvRecord>().ToList();

foreach (var rec in records)
{
    Console.WriteLine($"{rec.NUM}: {rec.NAME} => {rec.VALUE}");
}
    

✔ エラー対策：「No members are mapped for type」の対処法

プロパティ名とCSVヘッダー名が一致していないと、以下のようなエラーが出ます：

No members are mapped for type 'CsvRecord'
    

▶ 解決方法1：プロパティ名をヘッダーと一致させる

▶ 解決方法2：[Name("ヘッダー名")] 属性を付ける

どちらを選ぶべきか？

• 小規模 or 一時的な処理 → TextFieldParser
• 中〜大規模 or 書き込み/マッピングも必要 → CsvHelper（推奨）

まとめ

C#でCSVを読み込む際に、改行やカンマを含むフィールドを安全に処理するには、TextFieldParser か CsvHelper を使うのがベストなのかもしれません

.NET 8 や LINQ と組み合わせれば、スマートで強力なCSV処理が可能になります。