C#でCSVファイルを読み込むには？CSVパースの基本とデータ処理手順を解説

CSVファイルの読み込みは、C#によるデータ処理で非常によく使われる処理ですが、単純そうに見えて罠が多いです。エンコーディング、区切り文字、改行や引用符の扱いなど、仕様が曖昧な部分で思わぬ不具合が起こりやすいです。本記事では「C# CSV ファイル 読み込み」というキーワードで検索するユーザーが知りたい、実用的で最新な手法と注意点、パフォーマンスの工夫まで、具体的なコード例を交えて丁寧に解説します。

C# CSV ファイル 読み込みの基本概要

CSVファイル読み込みの基本とはまず何かを理解することです。CSV（Comma Separated Values）はテキストファイルで、各行がレコード、区切り文字でフィールドを分けます。C#ではシステムが提供する標準機能／ライブラリ／外部パッケージなど、複数の方法があり、用途に応じて使い分けることが重要です。最新情報を基に、どの方法がいつ適切かを整理します。

CSVフォーマットで気をつけるルールと特性

CSVが単純そうに見えて複雑さを帯びる理由には以下があります。
1．フィールドに区切り文字（通常のカンマ）が含まれる場合、ダブルクオーテーションで囲む必要があること。
2．フィールドに改行を含むケースがあり、また引用符内の引用符をどう表現するかなどの仕様差異。
3．使用される文字コード（UTF-8, Shift_JIS, EUC_JPなど）や、BOMの有無による文字化けリスク。
こうした要素を押さえないと、読み込み結果が乱れ、後続の処理に致命的な影響を及ぼします。

C#の標準機能：StreamReader／File.ReadLines／TextFieldParser

C#でCSVを読み込む際の標準的なメソッドとしては、StreamReaderやFile.ReadLines（またはReadAllLines）を利用した方法があります。比較的短いファイル／メモリ容量に余裕がある場合には使いやすいですが、大きなファイルではメモリ問題が生じることがあります。
また、TextFieldParserクラスは、区切り文字／引用符／改行などCSVの細かい仕様に対応している標準的機能で、安全に読み込む方法として推奨されます。

外部ライブラリでの読み込み：CsvHelperやIronXLなど

CSVの仕様差異や大量データ、マッピングや型変換が必要な場合、外部ライブラリの利用が便利です。CsvHelperは型マッピングや属性／フルエントマッピングに対応しており、フィールドごとの型変換などが柔軟に行えます。IronXLはExcel形式も扱えるなど複合フォーマット対応が強みです。これらを使うことで、自前のパーサーで陥りがちなエラーを避けられます。

C# CSV ファイル 読み込みで陥りやすいケースと対策

CSV読み込みの実務では、基本を知っていても誤動作するケースが少なくありません。ここでは具体的な「こういうCSVでこうなる」というパターンを取り上げ、それぞれの対策を説明します。

区切り文字がカンマ以外の場合

CSV形式といっても、区切り文字がカンマ以外（セミコロン／タブ／パイプなど）を使うものが存在します。特にヨーロッパ圏などではセミコロンが一般的なこともあります。対策として、TextFieldParserやCsvHelperのデリミタ指定機能を使って正しい区切り文字を設定することが必要です。またファイルを配布する際には、どの区切り文字が使われているかを文書化しておくとトラブル回避になります。

引用符と改行を含むフィールドの扱い

フィールド内に改行や区切り文字、引用符（ダブルクオート）を含むケースは、CSVで最も処理が難しい部分です。例えば「”New York, NY”」のような区切り文字混入、あるいは「”Line1
Line2″」のような改行を含む文字列です。TextFieldParserやCsvHelperではこうした仕様に準拠した読み込みが可能です。自前でSplit(‘,’)などを使うと簡単にエラーが発生します。

文字コードとBOMの影響

文字化けが起こる主な原因として、ファイルのエンコーディングの不一致があります。UTF-8／Shift_JIS／その他といったエンコーディング、さらにUTF-8 BOMの有無によって、先頭の文字が不正に認識されることがあります。StreamReaderやFileStreamを用いる際には、Encodingを明示すること、BOMを無視する／読み取る設定が可能なライブラリを使うことが重要です。

C# CSV ファイル 読み込みの手順とコード例

CSVファイル読み込みを実務で使える形で行う手順を以下に示します。これを一つ一つ実装することで、安全で再現性のある処理を構築できます。

準備：環境とプロジェクト設定

Visual Studioまたは別のIDEでC#プロジェクトを用意します。対象の.NETバージョンを確認し、必要であれば.NET Core／.NET 5／.NET 6以降を使います。外部ライブラリを使うならNuGetからCsvHelperやIronXLなどを追加します。参照アセンブリを忘れず追加（例えばTextFieldParserを使う場合はMicrosoft.VisualBasic参照）することも初期準備に含まれます。

基本実装：StreamReader + 手動パース例

たとえば簡単なCSVファイルを読み込み、全データをコンソール出力する例を示します。

using (var reader = new System.IO.StreamReader("ファイルパス", Encoding.UTF8))

{

　string headerLine = reader.ReadLine();

　while (!reader.EndOfStream)

　{

　　string line = reader.ReadLine();

　　if (string.IsNullOrWhiteSpace(line)) continue;

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

　　// fields[0], fields[1] など処理を記述

　}

}

この方法は構造が単純なCSVには有効ですが、先述の仕様差異には対応できません。

改善実装：TextFieldParser の利用例

TextFieldParserを使うと、多くの仕様差異に対応できます。ヘッダー行あり／なし、引用符あり、区切り文字指定などを簡単に取り入れられます。

using Microsoft.VisualBasic.FileIO;

using (var parser = new TextFieldParser("ファイルパス", Encoding.GetEncoding("Shift_JIS")))

{

　parser.TextFieldType = FieldType.Delimited;

　parser.SetDelimiters(",");

　parser.HasFieldsEnclosedInQuotes = true;

　string[] headers = parser.ReadFields();

　while (!parser.EndOfData)

　{

　　string[] fields = parser.ReadFields();

　　// fields を使った処理

　}

}

文字コード指定や引用符制御などにより、日本語のCSVなどでも安全に読み込めます。

実践実装：CsvHelper を使った POCOマッピング例

より複雑なCSVを扱う場合、CsvHelperで独自クラスにマッピングする方法が非常に使いやすいです。

public class MyRecord { public string Name { get; set; } public int Age { get; set; } public DateTime Date { get; set; } }

using (var reader = new System.IO.StreamReader("ファイルパス", Encoding.UTF8))

using (var csv = new CsvHelper.CsvReader(reader, System.Globalization.CultureInfo.InvariantCulture))

{

　csv.Configuration.HasHeaderRecord = true;

　var records = csv.GetRecords();

　foreach (var rec in records)

　{

　　// rec.Name, rec.Age, rec.Date を使った処理

　}

}

型変換や日付フォーマット指定、ヘッダー名の変更なども可能であり、可読性と保守性に優れます。

C# CSV ファイル 読み込みで性能を上げる工夫

ファイルサイズが大きくなればなるほど、読み込み方式により処理時間・メモリ使用量に差が出ます。処理速度とメモリ効率を向上させるための実践的な工夫を紹介します。

StreamReader vs File.ReadLines の使い分け

全行を一度に読み込む File.ReadAllLines は簡単ですがメモリを大量に消費します。一方で File.ReadLines は遅延読み込みを行い、一行ずつ取得するため、大きなファイルでもメモリ消費が抑えられます。StreamReader を用いて ReadLine をループする方式も同様にメモリ効率が良く、多くの行を処理する際に有利です。

バッファサイズとファイルアクセス設定の調整

FileStream や StreamReader を使う際、バッファサイズを適切に設定することでディスクアクセスの回数を減らして高速化できます。また、FileOptions.SequentialScan を指定するとOSに対して直列アクセスを通知でき、キャッシュ効率が上がります。これらは大きなファイルを扱う際に特に効果があります。

型変換と遅延評価を活用する

CSVから読み込んだ文字列をその場で int／decimal／DateTime に変換するとき、TryParse 系を使うことで例外を避けつつ処理できます。また、外部ライブラリでは遅延評価（yield return や IEnumerable）をサポートし、すべてのデータを一度にメモリに保持しない設計が可能です。大量データ処理時にはこのパターンが鍵になります。

C# CSV ファイル 読み込みの例外処理とテスト設計

読み込み処理では予想外の例外が発生しやすいため、堅牢な例外処理と適切なテストが不可欠です。読み込み失敗でアプリが止まってしまうとユーザービリティにも影響します。ここでは扱うべき例外ケースとテストのヒントを述べます。

読み込み時の代表的な例外ケース

主な例外には、ファイルが見つからない FileNotFoundException、アクセス拒否 UnauthorizedAccessException、文字エンコーディングによる文字化け、列数が揃っていない行や空行の存在などが含まれます。これらを try-catch ブロックで捕捉し、ログを残すか通知することで問題の切り分けが容易になります。

ユニットテストと結合テストの設計ポイント

テストは、次のようなケースを含めます：正常なCSV、フィールドに改行や区切り文字を含むCSV、引用符あり／なし、異なる区切り文字、空行や BOMあり／なし、エンコーディングが違うケースなど。ユニットテストで小さなCSVを使い、結合テストで本番に近い大きなCSVを使うことで安定性を確保できます。

実際の用途別ケーススタディ

実務でよくある用途ごとに適したアプローチを見ていきます。用途によって最適な手法が異なりますので、自分の目的に合うケースを選べるようにしておきます。

バッチ処理で毎日大量のCSVを取り込む場合

数十万行〜数百万行のCSVが定期的に供給されるバッチ処理では、メモリ効率と処理安定性が重要になります。StreamReader または File.ReadLines を使って一行ずつ処理し、バッファを利用して一度に処理するレコード数を制限することで、リソースの急激な消費を防ぎます。また外部ライブラリを使って非同期 I/O や並列処理を導入することも検討に値します。

ユーザーがアップロードするCSVをウェブアプリで処理する場合

ユーザー入力やアップロードファイルにはフォーマットが予測できないものが混じります。ヘッダーの有無、列数の不一致、空セルや余分な空白、文字化けなどをチェックするバリデーションコードを組み込むことが重要です。CsvHelper や TextFieldParser によるエラーキャッチ機能を活用し、必要ならユーザーにフィードバックするような設計が望ましいです。

リアルタイム連携やストリーミング読み込みが必要なケース

ファイル全体を一度に読み込む余裕がないシステムでは、ストリーミング形式での読み込みが求められます。ネットワークやパイプ経由で受け取るCSVデータ、あるいは大きなログファイルなど。こうした場面では StreamReader や外部ライブラリの非同期操作を組み合わせ、遅延評価を用いた処理で応答性とメモリ効率を両立できます。

ツール比較：読み込み方法のメリット・デメリット

複数の読み込み手段を比較することで、自分の用途に最もフィットする方法を選べます。以下の表は代表的な読み込み方法と、その長所・短所を整理したものです。

まとめ

C#でCSVファイルを読み込む際には、基本仕様をしっかり理解したうえで、用途に合った手法を選ぶことが成功の鍵です。標準機能だけでも十分なケースがありますが、引用符／改行／エンコーディングなどの仕様に対処するには、TextFieldParserや外部ライブラリの利用が効果的です。
大きなファイルを扱う場合は、StreamReader／File.ReadLines を用いた遅延読み込みやバッファ制御、並列・非同期処理を検討してください。例外処理とテストの充実も忘れずに。
この解説が、あなたが「C# CSV ファイル 読み込み」で求めている情報を満たし、実務で使える具体的な知見を提供できたと信じています。