C#でCSVを読み書きする方法｜文字化け・カンマ・改行の悩みを解決する実装ガイド

はじめに

C#でCSVを読み書きする処理は、業務システム、データ連携、ログ出力、Excel取り込み、マスタデータ管理などで頻繁に登場します。一見すると「カンマで区切られたテキストファイルを読み書きするだけ」に見えますが、実際には文字化け、カンマを含む値、ダブルクォート、改行、Excelで開いたときの表示崩れ、大容量ファイルのメモリ不足など、つまずきやすいポイントが多くあります。

C#でCSVを扱う方法には、大きく分けて次の2つがあります。

C#
// 標準クラスで処理する方法
StreamReader
StreamWriter

// ライブラリを使う方法
CsvHelper

単純なCSVであれば、StreamReaderやStreamWriterだけでも十分に対応できます。一方、値の中にカンマや改行が含まれるCSV、列のマッピングが必要なCSV、保守性を重視したい実務コードでは、CsvHelperのようなCSVライブラリを使うのが安全です。

この記事では、C#でCSVを読み書きする基本から、文字化け対策、カンマ・改行・ダブルクォートへの対応、CsvHelperの使い方、DataTableやListとの変換、実務向けのサンプルコードまで順番に解説します。

1. C#でCSVを扱う前に知っておきたい基本

1-1. CSVとは何か｜C#で扱う場面とよくある用途

CSVは「Comma-Separated Values」の略で、値をカンマで区切って表現するテキスト形式のデータです。

たとえば、次のようなファイルがCSVです。

csv
Id,Name,Age
1,山田太郎,30
2,佐藤花子,25
3,田中一郎,40

C#でCSVを扱う場面は多く、たとえば次のような用途があります。

• データベースの内容をCSVとしてエクスポートする

• Excelで作成されたCSVをシステムに取り込む

• 外部システムとのデータ連携に使う

• バッチ処理で大量データを読み込む

• ログや集計結果をCSVとして保存する

• マスタデータをCSVで管理する

CSVはシンプルで扱いやすい一方、仕様を正しく理解せずに実装すると、列ずれや文字化けが発生しやすい形式でもあります。

1-2. C#でCSVを読み書きする主な方法

C#でCSVを読み書きする方法は、主に次の2つです。

1つ目は、StreamReaderとStreamWriterを使って自分で読み書きする方法です。

C#
using var reader = new StreamReader("sample.csv");
string? line = reader.ReadLine();

C#
using var writer = new StreamWriter("sample.csv");
writer.WriteLine("Id,Name,Age");

2つ目は、CsvHelperなどのCSVライブラリを使う方法です。

C#
using var reader = new StreamReader("sample.csv");
using var csv = new CsvHelper.CsvReader(reader, System.Globalization.CultureInfo.InvariantCulture);

単純なCSVなら標準クラスで十分ですが、実務ではカンマ、ダブルクォート、改行、文字コード、ヘッダー有無などを考慮する必要があるため、ライブラリを使ったほうが安全な場面も多いです。

1-3. StreamReader・StreamWriterを使う場合のメリットと注意点

StreamReaderとStreamWriterを使うメリットは、C#標準のクラスだけでCSVを読み書きできることです。追加のライブラリをインストールする必要がなく、処理内容も理解しやすいです。

たとえば、単純なCSVの読み込みは次のように書けます。

C#
using var reader = new StreamReader("users.csv");

while (!reader.EndOfStream)
{
    string? line = reader.ReadLine();

    if (line == null)
    {
        continue;
    }

    string[] values = line.Split(',');

    Console.WriteLine(values[0]);
}

ただし、Split(',')には大きな注意点があります。値の中にカンマが含まれる場合、正しく分割できません。

csv
Id,Name,Address
1,山田太郎,"東京都渋谷区, 1-2-3"

このようなCSVをSplit(',')で分割すると、住所の中のカンマまで区切りとして扱われ、列がずれてしまいます。

そのため、StreamReaderとStreamWriterで処理する場合は、対象のCSVが本当に単純な形式かどうかを確認することが重要です。

1-4. CsvHelperなどのライブラリを使うべきケース

次のようなCSVを扱う場合は、CsvHelperなどのライブラリを使うのがおすすめです。

• 値の中にカンマが含まれる

• 値の中にダブルクォートが含まれる

• 値の中に改行が含まれる

• ヘッダー名とC#のクラス名をマッピングしたい

• 列の順番が変わる可能性がある

• 大量データを安全に処理したい

• 実務アプリとして保守性を高めたい

• CSVの仕様に沿った読み書きをしたい

CsvHelperを使うと、次のようにCSVをクラスへ直接変換できます。

C#
public class User
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public int Age { get; set; }
}

C#
using var reader = new StreamReader("users.csv");
using var csv = new CsvHelper.CsvReader(reader, System.Globalization.CultureInfo.InvariantCulture);

List<User> users = csv.GetRecords<User>().ToList();

CSVの列とC#のクラスを対応させられるため、実務コードでは可読性と保守性が高くなります。

1-5. CSV処理で初心者がつまずきやすいポイント

C#のCSV処理で初心者がよくつまずくポイントは、次のとおりです。

• 日本語が文字化けする

• Shift_JISのCSVをUTF-8として読んでしまう

• Excelで開くと文字化けする

• 値の中にカンマがあり、列がずれる

• 値の中に改行があり、行が分割される

• ダブルクォートのエスケープを忘れる

• ヘッダー行をデータとして処理してしまう

• ファイルが存在しないと例外になる

• ファイルがExcelで開かれていて書き込みできない

• 大容量CSVを一度に読み込み、メモリ不足になる

特に「文字コード」と「CSV仕様」は重要です。C#でCSVを扱うときは、単に文字列をカンマで分割するだけではなく、実際のデータ内容に合わせて処理方法を選ぶ必要があります。

2. C#でCSVファイルを読み込む基本実装

2-1. StreamReaderでCSVファイルを1行ずつ読み込む方法

C#でCSVファイルを読み込む基本は、StreamReaderを使って1行ずつ処理する方法です。

C#
using System.Text;

string path = "users.csv";

using var reader = new StreamReader(path, Encoding.UTF8);

while (!reader.EndOfStream)
{
    string? line = reader.ReadLine();

    if (line == null)
    {
        continue;
    }

    Console.WriteLine(line);
}

ReadLine()は1行ずつ読み込むため、大容量CSVでも比較的メモリを抑えて処理できます。

次のようにFile.ReadAllLines()を使う方法もあります。

C#
string[] lines = File.ReadAllLines("users.csv", Encoding.UTF8);

ただし、File.ReadAllLines()はファイル全体を一度にメモリへ読み込みます。小さなCSVなら便利ですが、大容量CSVではメモリ不足の原因になるため注意が必要です。

実務では、基本的にStreamReaderで1行ずつ処理する方法をおすすめします。

2-2. Splitでカンマ区切りの値を配列に変換する方法

単純なCSVであれば、Split(',')でカンマ区切りの値を配列に変換できます。

C#
string line = "1,山田太郎,30";

string[] values = line.Split(',');

Console.WriteLine(values[0]); // 1
Console.WriteLine(values[1]); // 山田太郎
Console.WriteLine(values[2]); // 30

CSVファイルを読み込みながら分割する例は次のとおりです。

C#
using System.Text;

string path = "users.csv";

using var reader = new StreamReader(path, Encoding.UTF8);

while (!reader.EndOfStream)
{
    string? line = reader.ReadLine();

    if (string.IsNullOrWhiteSpace(line))
    {
        continue;
    }

    string[] values = line.Split(',');

    string id = values[0];
    string name = values[1];
    string age = values[2];

    Console.WriteLine($"{id}: {name} ({age})");
}

ただし、この方法は「値の中にカンマが含まれない」ことが前提です。

csv
1,山田太郎,"東京都渋谷区, 1-2-3"

このようなCSVではSplit(',')だけでは正しく処理できません。カンマや改行を含む可能性があるCSVでは、後述するCsvHelperや専用のパース処理を使うべきです。

2-3. ヘッダー行を除外してデータ行だけ処理する方法

CSVには、1行目に列名が入っていることがよくあります。

csv
Id,Name,Age
1,山田太郎,30
2,佐藤花子,25

この場合、1行目のヘッダーを除外してデータ行だけ処理します。

C#
using System.Text;

string path = "users.csv";

using var reader = new StreamReader(path, Encoding.UTF8);

// 1行目のヘッダーを読み飛ばす
string? header = reader.ReadLine();

while (!reader.EndOfStream)
{
    string? line = reader.ReadLine();

    if (string.IsNullOrWhiteSpace(line))
    {
        continue;
    }

    string[] values = line.Split(',');

    Console.WriteLine($"ID: {values[0]}, Name: {values[1]}, Age: {values[2]}");
}

行番号を使ってヘッダーを判定する方法もあります。

C#
using System.Text;

string path = "users.csv";
int lineNumber = 0;

using var reader = new StreamReader(path, Encoding.UTF8);

while (!reader.EndOfStream)
{
    string? line = reader.ReadLine();
    lineNumber++;

    if (lineNumber == 1)
    {
        continue;
    }

    if (string.IsNullOrWhiteSpace(line))
    {
        continue;
    }

    string[] values = line.Split(',');
    Console.WriteLine(values[1]);
}

ヘッダー行があるかどうかはCSVによって異なるため、処理前に仕様を確認しておきましょう。

2-4. 読み込んだCSVデータをListやクラスに格納する方法

CSVを読み込んだ後は、配列のまま扱うよりも、クラスに変換してList<T>へ格納すると扱いやすくなります。

まず、CSVの1行に対応するクラスを作成します。

C#
public class User
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public int Age { get; set; }
}

CSVを読み込み、List<User>に格納します。

C#
using System.Text;

string path = "users.csv";
List<User> users = new();

using var reader = new StreamReader(path, Encoding.UTF8);

// ヘッダー行を読み飛ばす
reader.ReadLine();

while (!reader.EndOfStream)
{
    string? line = reader.ReadLine();

    if (string.IsNullOrWhiteSpace(line))
    {
        continue;
    }

    string[] values = line.Split(',');

    User user = new User
    {
        Id = int.Parse(values[0]),
        Name = values[1],
        Age = int.Parse(values[2])
    };

    users.Add(user);
}

foreach (User user in users)
{
    Console.WriteLine($"{user.Id}: {user.Name} - {user.Age}");
}

実務では、int.Parse()で変換に失敗すると例外が発生するため、int.TryParse()を使うとより安全です。

C#
if (!int.TryParse(values[0], out int id))
{
    Console.WriteLine("IDの形式が不正です。");
    continue;
}

if (!int.TryParse(values[2], out int age))
{
    Console.WriteLine("Ageの形式が不正です。");
    continue;
}

CSVの内容は外部データであることが多いため、常に不正な値が入る可能性を考えて実装することが大切です。

2-5. ファイルが存在しない場合の例外処理

CSVファイルを読み込むとき、指定したファイルが存在しないとFileNotFoundExceptionが発生します。

事前にFile.Exists()で確認すると安全です。

C#
using System.Text;

string path = "users.csv";

if (!File.Exists(path))
{
    Console.WriteLine("CSVファイルが存在しません。");
    return;
}

using var reader = new StreamReader(path, Encoding.UTF8);

while (!reader.EndOfStream)
{
    string? line = reader.ReadLine();
    Console.WriteLine(line);
}

try-catchで例外処理を行う方法もあります。

C#
using System.Text;

string path = "users.csv";

try
{
    using var reader = new StreamReader(path, Encoding.UTF8);

    while (!reader.EndOfStream)
    {
        string? line = reader.ReadLine();
        Console.WriteLine(line);
    }
}
catch (FileNotFoundException)
{
    Console.WriteLine("CSVファイルが見つかりません。");
}
catch (UnauthorizedAccessException)
{
    Console.WriteLine("CSVファイルへのアクセス権限がありません。");
}
catch (IOException ex)
{
    Console.WriteLine($"CSVファイルの読み込み中にエラーが発生しました: {ex.Message}");
}

実務では、ファイルの存在確認だけでなく、アクセス権限、ファイルロック、文字コード、データ形式の不正も考慮しましょう。

3. C#でCSVファイルを書き込む基本実装

3-1. StreamWriterでCSVファイルを作成する方法

C#でCSVファイルを書き込む基本は、StreamWriterを使います。

C#
using System.Text;

string path = "users.csv";

using var writer = new StreamWriter(path, false, Encoding.UTF8);

writer.WriteLine("Id,Name,Age");
writer.WriteLine("1,山田太郎,30");
writer.WriteLine("2,佐藤花子,25");

StreamWriterの第2引数は追記するかどうかを指定します。

C#
new StreamWriter(path, false, Encoding.UTF8); // 上書き
new StreamWriter(path, true, Encoding.UTF8);  // 追記

CSVを新規作成したい場合はfalse、既存ファイルに追記したい場合はtrueを指定します。

3-2. Listや配列のデータをCSV形式で出力する方法

配列やListのデータをCSV形式で出力する場合、string.Join()を使うと簡単です。

C#
using System.Text;

string path = "users.csv";

List<string[]> rows = new()
{
    new[] { "1", "山田太郎", "30" },
    new[] { "2", "佐藤花子", "25" },
    new[] { "3", "田中一郎", "40" }
};

using var writer = new StreamWriter(path, false, Encoding.UTF8);

foreach (string[] row in rows)
{
    string line = string.Join(",", row);
    writer.WriteLine(line);
}

クラスのListをCSVとして出力する例です。

C#
public class User
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public int Age { get; set; }
}

C#
using System.Text;

string path = "users.csv";

List<User> users = new()
{
    new User { Id = 1, Name = "山田太郎", Age = 30 },
    new User { Id = 2, Name = "佐藤花子", Age = 25 }
};

using var writer = new StreamWriter(path, false, Encoding.UTF8);

foreach (User user in users)
{
    writer.WriteLine($"{user.Id},{user.Name},{user.Age}");
}

ただし、この方法も値の中にカンマや改行が含まれないことが前提です。安全なCSV出力を行う場合は、後述するエスケープ処理を入れる必要があります。

3-3. ヘッダー行付きのCSVを書き出す方法

CSVをExcelや別システムで扱う場合、1行目にヘッダーを付けることがよくあります。

C#
using System.Text;

string path = "users.csv";

List<User> users = new()
{
    new User { Id = 1, Name = "山田太郎", Age = 30 },
    new User { Id = 2, Name = "佐藤花子", Age = 25 }
};

using var writer = new StreamWriter(path, false, Encoding.UTF8);

// ヘッダー行
writer.WriteLine("Id,Name,Age");

// データ行
foreach (User user in users)
{
    writer.WriteLine($"{user.Id},{user.Name},{user.Age}");
}

ヘッダー名は、読み込む側の仕様に合わせる必要があります。

たとえば、C#のプロパティ名はNameでも、CSVの列名は日本語で氏名にしたい場合があります。

C#
writer.WriteLine("ID,氏名,年齢");

業務システムでは、CSVの列名が外部システムとの連携仕様になっていることも多いため、勝手に変更しないよう注意しましょう。

3-4. 既存CSVに追記する方法

既存のCSVにデータを追記する場合は、StreamWriterの第2引数にtrueを指定します。

C#
using System.Text;

string path = "users.csv";

using var writer = new StreamWriter(path, true, Encoding.UTF8);

writer.WriteLine("3,田中一郎,40");

ただし、追記時に毎回ヘッダーを書いてしまうと、ファイルの途中にヘッダー行が混ざってしまいます。

csv
Id,Name,Age
1,山田太郎,30
2,佐藤花子,25
Id,Name,Age
3,田中一郎,40

そのため、ファイルが存在しない場合だけヘッダーを書き込むようにすると便利です。

C#
using System.Text;

string path = "users.csv";
bool exists = File.Exists(path);

using var writer = new StreamWriter(path, true, Encoding.UTF8);

if (!exists)
{
    writer.WriteLine("Id,Name,Age");
}

writer.WriteLine("3,田中一郎,40");

既存ファイルが空の場合もヘッダーを書きたい場合は、ファイルサイズも確認します。

C#
bool shouldWriteHeader = !File.Exists(path) || new FileInfo(path).Length == 0;

using var writer = new StreamWriter(path, true, Encoding.UTF8);

if (shouldWriteHeader)
{
    writer.WriteLine("Id,Name,Age");
}

writer.WriteLine("3,田中一郎,40");

3-5. 書き込み時の例外処理とファイルロック対策

CSVを書き込むときは、ファイルがExcelなどで開かれているとIOExceptionが発生することがあります。

C#
using System.Text;

string path = "users.csv";

try
{
    using var writer = new StreamWriter(path, false, Encoding.UTF8);

    writer.WriteLine("Id,Name,Age");
    writer.WriteLine("1,山田太郎,30");
}
catch (UnauthorizedAccessException)
{
    Console.WriteLine("CSVファイルへの書き込み権限がありません。");
}
catch (IOException ex)
{
    Console.WriteLine($"CSVファイルに書き込めません。ファイルが開かれている可能性があります: {ex.Message}");
}

ファイルロックを避けるためには、次の点に注意します。

• usingを使ってファイルを確実に閉じる

• ExcelでCSVを開いたまま書き込まない

• 同じファイルに複数プロセスから同時に書き込まない

• 一時ファイルに書き出してから置き換える

• 書き込み中に例外が起きた場合のログを残す

実務では、CSV出力中にアプリが停止すると中途半端なファイルが残ることがあります。その対策として、一度.tmpファイルに出力し、成功後に正式ファイルへリネームする設計も有効です。

C#
using System.Text;

string path = "users.csv";
string tempPath = path + ".tmp";

try
{
    using (var writer = new StreamWriter(tempPath, false, Encoding.UTF8))
    {
        writer.WriteLine("Id,Name,Age");
        writer.WriteLine("1,山田太郎,30");
    }

    File.Copy(tempPath, path, true);
    File.Delete(tempPath);
}
catch (IOException ex)
{
    Console.WriteLine($"CSV出力に失敗しました: {ex.Message}");
}

4. CSVの文字化けを防ぐエンコーディング設定

4-1. C#でCSVが文字化けする原因

C#でCSVが文字化けする主な原因は、読み込み時または書き込み時の文字コードが実際のCSVファイルと一致していないことです。

たとえば、Shift_JISで保存されたCSVをUTF-8として読み込むと、日本語が文字化けすることがあります。

C#
// Shift_JISのCSVをUTF-8として読んでしまう例
using var reader = new StreamReader("users.csv", Encoding.UTF8);

また、C#でUTF-8のCSVを出力しても、Excel側がShift_JISとして開こうとして文字化けするケースがあります。

CSVでよく使われる文字コードには、次のようなものがあります。

C#でCSVを読み書きするときは、文字コードを明示するのが基本です。

4-2. UTF-8でCSVを読み書きする方法

UTF-8でCSVを読み込む場合は、StreamReaderにEncoding.UTF8を指定します。

C#
using System.Text;

string path = "users.csv";

using var reader = new StreamReader(path, Encoding.UTF8);

while (!reader.EndOfStream)
{
    string? line = reader.ReadLine();
    Console.WriteLine(line);
}

UTF-8でCSVを書き込む場合は、StreamWriterにEncoding.UTF8を指定します。

C#
using System.Text;

string path = "users.csv";

using var writer = new StreamWriter(path, false, Encoding.UTF8);

writer.WriteLine("Id,Name,Age");
writer.WriteLine("1,山田太郎,30");

BOMなしUTF-8を明示したい場合は、次のようにします。

C#
using System.Text;

var utf8NoBom = new UTF8Encoding(encoderShouldEmitUTF8Identifier: false);

using var writer = new StreamWriter("users.csv", false, utf8NoBom);

writer.WriteLine("Id,Name,Age");
writer.WriteLine("1,山田太郎,30");

Excelで直接開くことを重視する場合は、BOM付きUTF-8を使うこともあります。

C#
using System.Text;

var utf8WithBom = new UTF8Encoding(encoderShouldEmitUTF8Identifier: true);

using var writer = new StreamWriter("users.csv", false, utf8WithBom);

writer.WriteLine("Id,Name,Age");
writer.WriteLine("1,山田太郎,30");

4-3. Shift_JISのCSVを読み込む方法

日本語の業務システムでは、Shift_JISのCSVを扱うことがあります。

.NET Frameworkでは次のように読み込めます。

C#
using System.Text;

Encoding shiftJis = Encoding.GetEncoding("shift_jis");

using var reader = new StreamReader("users.csv", shiftJis);

while (!reader.EndOfStream)
{
    string? line = reader.ReadLine();
    Console.WriteLine(line);
}

.NET Coreや.NET 5以降でShift_JISを扱う場合、環境によってはEncoding.RegisterProviderが必要です。

C#
using System.Text;

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

Encoding shiftJis = Encoding.GetEncoding("shift_jis");

using var reader = new StreamReader("users.csv", shiftJis);

while (!reader.EndOfStream)
{
    string? line = reader.ReadLine();
    Console.WriteLine(line);
}

書き込み時も同様です。

C#
using System.Text;

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

Encoding shiftJis = Encoding.GetEncoding("shift_jis");

using var writer = new StreamWriter("users.csv", false, shiftJis);

writer.WriteLine("Id,Name,Age");
writer.WriteLine("1,山田太郎,30");

ただし、Shift_JISでは扱えない文字もあります。絵文字、特殊記号、機種依存文字などが含まれる可能性がある場合は、UTF-8を検討しましょう。

4-4. Excelで開いたときに文字化けしないCSVを出力する方法

ExcelでCSVを直接開いたときに文字化けする場合、BOM付きUTF-8で出力すると改善することがあります。

C#
using System.Text;

string path = "users.csv";
var utf8WithBom = new UTF8Encoding(encoderShouldEmitUTF8Identifier: true);

using var writer = new StreamWriter(path, false, utf8WithBom);

writer.WriteLine("Id,Name,Age");
writer.WriteLine("1,山田太郎,30");
writer.WriteLine("2,佐藤花子,25");

古いExcelや特定の業務環境では、Shift_JISのほうが期待どおりに開けることもあります。

C#
using System.Text;

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

Encoding shiftJis = Encoding.GetEncoding("shift_jis");

using var writer = new StreamWriter("users.csv", false, shiftJis);

writer.WriteLine("Id,Name,Age");
writer.WriteLine("1,山田太郎,30");

どちらを選ぶべきかは、CSVを利用する相手によって変わります。

• Webシステムや新しいアプリとの連携ならUTF-8

• Excelで直接開くことが多いならBOM付きUTF-8

• 古い業務システムとの連携ならShift_JIS

• 仕様書で指定されている場合は仕様書を優先

CSV出力では、文字コードを暗黙にせず、必ず明示することが重要です。

4-5. Encoding.RegisterProviderが必要になるケース

.NET Coreや.NET 5以降でEncoding.GetEncoding("shift_jis")を使う場合、次のような例外が発生することがあります。

System.ArgumentException: 'shift_jis' is not a supported encoding name.

この場合は、System.Text.Encoding.CodePagesパッケージを追加し、次のコードを実行します。

C#
using System.Text;

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

その後、Shift_JISを取得できます。

C#
Encoding shiftJis = Encoding.GetEncoding("shift_jis");

コンソールアプリであれば、Mainメソッドの最初に書いておくとよいです。

C#
using System.Text;

class Program
{
    static void Main()
    {
        Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

        Encoding shiftJis = Encoding.GetEncoding("shift_jis");

        using var reader = new StreamReader("users.csv", shiftJis);

        while (!reader.EndOfStream)
        {
            Console.WriteLine(reader.ReadLine());
        }
    }
}

Shift_JISのCSVを扱う可能性があるプロジェクトでは、早い段階で文字コード対応を決めておきましょう。

5. カンマ・ダブルクォート・改行を含むCSVの正しい扱い方

5-1. Splitだけでは正しく処理できないCSVの例

CSV処理でよくある失敗が、すべてのCSVをSplit(',')で処理してしまうことです。

次のCSVを考えてみます。

csv
Id,Name,Address
1,山田太郎,"東京都渋谷区, 1-2-3"

Split(',')で分割すると、住所の中のカンマまで区切り文字として扱われます。

C#
string line = "1,山田太郎,\"東京都渋谷区, 1-2-3\"";

string[] values = line.Split(',');

Console.WriteLine(values.Length); // 4になってしまう

本来は3列ですが、4列として扱われてしまいます。

また、次のように改行を含む値もあります。

csv
Id,Name,Memo
1,山田太郎,"1行目
2行目"

この場合、ReadLine()で1行ずつ読み込むだけでは、1レコードが途中で分割されてしまいます。

このようなCSVを扱う場合は、CSV仕様に沿ったパーサーを使う必要があります。実務ではCsvHelperの利用をおすすめします。

5-2. カンマを含む値をダブルクォートで囲む方法

CSVでは、値の中にカンマが含まれる場合、その値をダブルクォートで囲みます。

csv
Id,Name,Address
1,山田太郎,"東京都渋谷区, 1-2-3"

C#で出力する場合は、値にカンマが含まれているかを判定し、必要に応じてダブルクォートで囲みます。

C#
static string EscapeCsvValue(string? value)
{
    if (value == null)
    {
        return "";
    }

    bool mustQuote =
        value.Contains(',') ||
        value.Contains('"') ||
        value.Contains('\r') ||
        value.Contains('\n');

    if (value.Contains('"'))
    {
        value = value.Replace("\"", "\"\"");
    }

    return mustQuote ? $"\"{value}\"" : value;
}

使い方は次のとおりです。

C#
string address = "東京都渋谷区, 1-2-3";

string line = string.Join(",", new[]
{
    EscapeCsvValue("1"),
    EscapeCsvValue("山田太郎"),
    EscapeCsvValue(address)
});

Console.WriteLine(line);

出力結果は次のようになります。

csv
1,山田太郎,"東京都渋谷区, 1-2-3"

CSVを書き出すときは、すべての値に対してエスケープ関数を通すと安全です。

5-3. ダブルクォートを含む値のエスケープ方法

CSVでは、値の中にダブルクォートが含まれる場合、ダブルクォートを2つにしてエスケープします。

たとえば、次の値があるとします。

彼は"OK"と言った

CSVでは次のように表現します。

csv
"彼は""OK""と言った"

C#ではReplace("\"", "\"\"")でエスケープできます。

C#
string text = "彼は\"OK\"と言った";

string escaped = text.Replace("\"", "\"\"");

Console.WriteLine($"\"{escaped}\"");

CSV出力用の関数としてまとめると、次のようになります。

C#
static string EscapeCsvValue(string? value)
{
    if (value == null)
    {
        return "";
    }

    bool mustQuote =
        value.Contains(',') ||
        value.Contains('"') ||
        value.Contains('\r') ||
        value.Contains('\n');

    value = value.Replace("\"", "\"\"");

    return mustQuote ? $"\"{value}\"" : value;
}

この関数を使えば、カンマ、ダブルクォート、改行を含む値を安全にCSV出力できます。

5-4. 改行を含むフィールドを扱うときの注意点

CSVでは、値の中に改行を含めることもできます。その場合、フィールド全体をダブルクォートで囲みます。

csv
Id,Name,Memo
1,山田太郎,"1行目
2行目
3行目"

C#でこのような値を出力する場合も、改行を含む値をダブルクォートで囲む必要があります。

C#
string memo = "1行目\n2行目\n3行目";

string line = string.Join(",", new[]
{
    EscapeCsvValue("1"),
    EscapeCsvValue("山田太郎"),
    EscapeCsvValue(memo)
});

Console.WriteLine(line);

ただし、読み込み側では注意が必要です。

StreamReader.ReadLine()は物理的な1行を読み込むため、改行を含むフィールドがある場合、CSVの1レコードを正しく読み取れません。

つまり、次のようなデータでは、1つのレコードが複数行にまたがります。

csv
1,山田太郎,"1行目
2行目"

このようなCSVを正しく読み込むには、自前でクォート状態を管理するか、CsvHelperのようなCSVパーサーを使う必要があります。

実務では、改行を含むフィールドがある可能性が少しでもあるなら、SplitとReadLineだけで処理しないほうが安全です。

5-5. RFC 4180に沿ったCSV処理の考え方

CSVには、一般的にRFC 4180に沿った考え方があります。すべてのCSVが厳密にRFC 4180準拠とは限りませんが、実装時の基準として理解しておくと便利です。

主なポイントは次のとおりです。

• 1レコードは通常1行で表す

• フィールドはカンマで区切る

• フィールドにカンマ、ダブルクォート、改行が含まれる場合はダブルクォートで囲む

• フィールド内のダブルクォートは2つのダブルクォートで表す

• ヘッダー行は任意

• 改行コードはCRLFが使われることが多い

たとえば、次のCSVはカンマ、ダブルクォート、改行を含む値を表しています。

csv
Id,Name,Memo
1,山田太郎,"東京都渋谷区, 1-2-3"
2,佐藤花子,"彼は""OK""と言った"
3,田中一郎,"1行目
2行目"

このようなCSVを安全に扱うには、CSV仕様に沿った処理が必要です。

単純なデータならSplitでも対応できますが、実務では「将来的に値の中にカンマや改行が入るかもしれない」と考えて設計することが大切です。

6. CsvHelperを使ってCSVを安全に読み書きする方法

6-1. CsvHelperを導入する方法

CsvHelperは、C#でCSVを扱うための代表的なライブラリです。カンマ、ダブルクォート、改行、ヘッダー、クラスマッピングなどを安全に扱えます。

NuGetでインストールします。

Bash
dotnet add package CsvHelper

Visual Studioを使っている場合は、NuGetパッケージマネージャーからCsvHelperを検索して追加できます。

CsvHelperを使うときは、主に次の名前空間を使用します。

C#
using CsvHelper;
using CsvHelper.Configuration;
using System.Globalization;
using System.Text;

基本的には、CsvReaderで読み込み、CsvWriterで書き込みます。

6-2. CsvHelperでCSVを読み込む基本コード

まず、CSVに対応するクラスを用意します。

C#
public class User
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public int Age { get; set; }
}

CSVファイルは次のような形式とします。

csv
Id,Name,Age
1,山田太郎,30
2,佐藤花子,25

CsvHelperで読み込むコードは次のとおりです。

C#
using CsvHelper;
using System.Globalization;
using System.Text;

string path = "users.csv";

using var reader = new StreamReader(path, Encoding.UTF8);
using var csv = new CsvReader(reader, CultureInfo.InvariantCulture);

List<User> users = csv.GetRecords<User>().ToList();

foreach (User user in users)
{
    Console.WriteLine($"{user.Id}: {user.Name} ({user.Age})");
}

GetRecords<User>()を使うと、CSVの各行をUserクラスのインスタンスとして取得できます。

ヘッダー名とプロパティ名が一致していれば、自動的にマッピングされます。

6-3. CsvHelperでCSVを書き出す基本コード

CsvHelperでCSVを書き出す場合は、CsvWriterを使います。

C#
using CsvHelper;
using System.Globalization;
using System.Text;

string path = "users.csv";

List<User> users = new()
{
    new User { Id = 1, Name = "山田太郎", Age = 30 },
    new User { Id = 2, Name = "佐藤花子", Age = 25 }
};

using var writer = new StreamWriter(path, false, Encoding.UTF8);
using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);

csv.WriteRecords(users);

このコードを実行すると、次のようなCSVが出力されます。

csv
Id,Name,Age
1,山田太郎,30
2,佐藤花子,25

CsvHelperは、値にカンマやダブルクォートが含まれている場合でも、必要に応じて正しくエスケープしてくれます。

たとえば、名前やメモにカンマが含まれていても、安全にCSVとして出力できます。

6-4. クラスとCSV列をマッピングする方法

CSVのヘッダー名とC#のプロパティ名が一致しない場合は、マッピングクラスを使います。

たとえば、CSVのヘッダーが日本語の場合を考えます。

csv
ID,氏名,年齢
1,山田太郎,30
2,佐藤花子,25

C#のクラスは次のように英語のプロパティ名にしておきます。

C#
public class User
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public int Age { get; set; }
}

マッピングクラスを作成します。

C#
using CsvHelper.Configuration;

public sealed class UserMap : ClassMap<User>
{
    public UserMap()
    {
        Map(m => m.Id).Name("ID");
        Map(m => m.Name).Name("氏名");
        Map(m => m.Age).Name("年齢");
    }
}

読み込み時にマッピングを登録します。

C#
using CsvHelper;
using System.Globalization;
using System.Text;

using var reader = new StreamReader("users.csv", Encoding.UTF8);
using var csv = new CsvReader(reader, CultureInfo.InvariantCulture);

csv.Context.RegisterClassMap<UserMap>();

List<User> users = csv.GetRecords<User>().ToList();

書き込み時にも同じマッピングを利用できます。

C#
using CsvHelper;
using System.Globalization;
using System.Text;

List<User> users = new()
{
    new User { Id = 1, Name = "山田太郎", Age = 30 }
};

using var writer = new StreamWriter("users.csv", false, Encoding.UTF8);
using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);

csv.Context.RegisterClassMap<UserMap>();
csv.WriteRecords(users);

マッピングを使うと、CSV仕様とC#のクラス設計を分離できるため、保守しやすくなります。

6-5. 文字コードやヘッダー有無を設定する方法

CsvHelperでも、文字コードはStreamReaderやStreamWriter側で指定します。

UTF-8で読み込む場合です。

C#
using var reader = new StreamReader("users.csv", Encoding.UTF8);
using var csv = new CsvReader(reader, CultureInfo.InvariantCulture);

Shift_JISで読み込む場合です。

C#
using System.Text;

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

Encoding shiftJis = Encoding.GetEncoding("shift_jis");

using var reader = new StreamReader("users.csv", shiftJis);
using var csv = new CsvReader(reader, CultureInfo.InvariantCulture);

ヘッダーがないCSVを読み込む場合は、CsvConfigurationでHasHeaderRecordをfalseにします。

C#
using CsvHelper;
using CsvHelper.Configuration;
using System.Globalization;
using System.Text;

var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    HasHeaderRecord = false
};

using var reader = new StreamReader("users.csv", Encoding.UTF8);
using var csv = new CsvReader(reader, config);

List<User> users = csv.GetRecords<User>().ToList();

ヘッダーなしCSVの場合、列の順番でマッピングする必要があります。

C#
using CsvHelper.Configuration;

public sealed class UserNoHeaderMap : ClassMap<User>
{
    public UserNoHeaderMap()
    {
        Map(m => m.Id).Index(0);
        Map(m => m.Name).Index(1);
        Map(m => m.Age).Index(2);
    }
}

C#
csv.Context.RegisterClassMap<UserNoHeaderMap>();
List<User> users = csv.GetRecords<User>().ToList();

6-6. カンマ・改行・ダブルクォートを含むCSVへの対応

CsvHelperを使う大きなメリットは、カンマ、改行、ダブルクォートを含むCSVを安全に扱えることです。

たとえば、次のようなクラスを用意します。

C#
public class Note
{
    public int Id { get; set; }
    public string Text { get; set; } = "";
}

次のようなデータを書き出します。

C#
using CsvHelper;
using System.Globalization;
using System.Text;

List<Note> notes = new()
{
    new Note { Id = 1, Text = "東京都渋谷区, 1-2-3" },
    new Note { Id = 2, Text = "彼は\"OK\"と言った" },
    new Note { Id = 3, Text = "1行目\n2行目" }
};

using var writer = new StreamWriter("notes.csv", false, Encoding.UTF8);
using var csv = new CsvWriter(writer, CultureInfo.InvariantCulture);

csv.WriteRecords(notes);

出力されるCSVでは、必要な値が自動的にダブルクォートで囲まれ、ダブルクォートも正しくエスケープされます。

読み込みも同様に、CsvHelperがCSV仕様に沿って処理してくれます。

C#
using CsvHelper;
using System.Globalization;
using System.Text;

using var reader = new StreamReader("notes.csv", Encoding.UTF8);
using var csv = new CsvReader(reader, CultureInfo.InvariantCulture);

List<Note> notes = csv.GetRecords<Note>().ToList();

foreach (Note note in notes)
{
    Console.WriteLine(note.Text);
}

Splitでは壊れやすいCSVでも、CsvHelperを使えば安全に読み書きできます。

7. DataTableやListとCSVを相互変換する方法

7-1. CSVをDataTableに読み込む方法

DataTableは、列と行を持つ表形式データとしてCSVを扱いたい場合に便利です。

単純なCSVをDataTableに読み込む例です。

C#
using System.Data;
using System.Text;

static DataTable ReadCsvToDataTable(string path, Encoding encoding)
{
    DataTable table = new();

    using var reader = new StreamReader(path, encoding);

    string? headerLine = reader.ReadLine();

    if (headerLine == null)
    {
        return table;
    }

    string[] headers = headerLine.Split(',');

    foreach (string header in headers)
    {
        table.Columns.Add(header);
    }

    while (!reader.EndOfStream)
    {
        string? line = reader.ReadLine();

        if (string.IsNullOrWhiteSpace(line))
        {
            continue;
        }

        string[] values = line.Split(',');
        table.Rows.Add(values);
    }

    return table;
}

使い方は次のとおりです。

C#
DataTable table = ReadCsvToDataTable("users.csv", Encoding.UTF8);

foreach (DataRow row in table.Rows)
{
    Console.WriteLine(row["Name"]);
}

ただし、この実装はSplit(',')を使っているため、カンマや改行を含むCSVには向いていません。複雑なCSVをDataTableに読み込む場合は、CsvHelperで読み込んでからDataTableに変換するほうが安全です。

7-2. DataTableをCSVとして出力する方法

DataTableをCSVとして出力する場合は、列名をヘッダーとして出力し、各行を順番に書き込みます。

C#
using System.Data;
using System.Text;

static void WriteDataTableToCsv(DataTable table, string path, Encoding encoding)
{
    using var writer = new StreamWriter(path, false, encoding);

    IEnumerable<string> headers = table.Columns
        .Cast<DataColumn>()
        .Select(column => EscapeCsvValue(column.ColumnName));

    writer.WriteLine(string.Join(",", headers));

    foreach (DataRow row in table.Rows)
    {
        IEnumerable<string> values = table.Columns
            .Cast<DataColumn>()
            .Select(column => EscapeCsvValue(row[column]?.ToString()));

        writer.WriteLine(string.Join(",", values));
    }
}

static string EscapeCsvValue(string? value)
{
    if (value == null)
    {
        return "";
    }

    bool mustQuote =
        value.Contains(',') ||
        value.Contains('"') ||
        value.Contains('\r') ||
        value.Contains('\n');

    value = value.Replace("\"", "\"\"");

    return mustQuote ? $"\"{value}\"" : value;
}

使い方は次のとおりです。

C#
DataTable table = new();
table.Columns.Add("Id");
table.Columns.Add("Name");
table.Columns.Add("Memo");

table.Rows.Add("1", "山田太郎", "東京都渋谷区, 1-2-3");
table.Rows.Add("2", "佐藤花子", "1行目\n2行目");

WriteDataTableToCsv(table, "users.csv", Encoding.UTF8);

このように、CSV出力時には必ずエスケープ処理を入れると安全です。

7-3. CSVをList<T>に変換する方法

C#でCSVを扱う場合、DataTableよりもList<T>に変換したほうが、型安全で扱いやすいことが多いです。

たとえば、ユーザー情報を表すクラスを用意します。

C#
public class User
{
    public int Id { get; set; }
    public string Name { get; set; } = "";
    public int Age { get; set; }
}

単純なCSVをList<User>に変換する例です。

C#
using System.Text;

static List<User> ReadUsers(string path, Encoding encoding)
{
    List<User> users = new();

    using var reader = new StreamReader(path, encoding);

    reader.ReadLine(); // ヘッダーを読み飛ばす

    while (!reader.EndOfStream)
    {
        string? line = reader.ReadLine();

        if (string.IsNullOrWhiteSpace(line))
        {
            continue;
        }

        string[] values = line.Split(',');

        if (values.Length < 3)
        {
            continue;
        }

        if (!int.TryParse(values[0], out int id))
        {
            continue;
        }

        if (!int.TryParse(values[2], out int age))
        {
            continue;
        }

        users.Add(new User
        {
            Id = id,
            Name = values[1],
            Age = age
        });
    }

    return users;
}