C#でCSVファイル読み込みをするには？基本コードと注意点を解説

プログラミングで「C# CSV ファイル 読み込み」を調べているなら、単にCSVを開くだけでなく、エラー回避、文字コード、値の中の区切り文字（カンマ等）、リッチなライブラリ利用まで、幅広く理解したいはずです。この記事では基礎から応用、最新のライブラリや開発現場で役立つ注意点までを網羅。コード例や比較表を交え、読み手がすぐに実践できる知識を提供します。

C# CSV ファイル 読み込みの基本方法

CSVとは「Comma Separated Values」の略で、データをテキスト形式で区切って保存するフォーマットです。C#でCSVファイルを読み込む基本ステップは、まずファイルを読み込む手段を確保し、その後行毎にデータを分割して扱います。小規模なデータならば標準のクラスで十分ですが、データ量が多かったり複雑なCSVを処理する場合は、ライブラリを使うほうが安全で効率的です。

代表的な方法として、StreamReaderを使って一行ずつ読み、Splitで区切るという基本的なコードがあります。簡潔なのが利点ですが、「値にカンマが含まれる」「引用符で囲まれている」「改行を含む」などの仕様を満たす必要があるCSVには対処できません。そこで、TextFieldParser等のクラスや、外部のCSV処理ライブラリが登場します。

File.ReadAllLines＋Splitでの読み込み

最もシンプルな方法は、File.ReadAllLinesでファイル全体を文字列配列に読み込み、それぞれの行をSplitで分割する形です。小さなファイルや簡単なデータの処理には適しています。コードは理解しやすく、依存ライブラリも不要です。

ただしこの方法は、大きなファイルではメモリ消費が激しくなる可能性があります。加えて、値にカンマや改行が含まれていたり、引用符で囲まれていたりする場合には期待通りに動かないことがあるので、仕様をよく確認する必要があります。

StreamReaderを使って1行ずつ処理する方法

File.ReadAllLinesとは異なり、StreamReaderを使うとファイル全体を一度に読み込まず、1行ずつ処理します。これによりメモリ負荷が抑えられ、大きなCSVでも比較的安全に扱えます。文字コード指定も可能で、日本語環境ではShift_JISやUTF-8などを指定できます。

具体的にはusingを用いてStreamReaderをインスタンス化し、whileループでEndOfStreamまでReadLineを呼び、それからSplitや他の処理を行います。エラー処理や例外処理もこの方法で組みやすいのが特徴です。

TextFieldParserクラスで高度なCSV仕様に対応

TextFieldParserクラスは、値にカンマが含まれる、引用符で囲まれている、ホワイトスペースの取り扱いなど、CSV仕様の複雑な要件にも対応できるクラスです。標準のSplitだけでは扱えないケースを簡潔に処理できるため、品質や保守性が求められるプロジェクトではこちらの利用が推奨されます。

設定可能なプロパティとして、Delimitersで区切り文字、HasFieldsEnclosedInQuotesで引用符付きデータの処理を行うかどうか、TrimWhiteSpaceで前後の空白をどう扱うかなどがあります。複雑なCSVファイルではこのような設定が役立ちます。

ライブラリを利用したCSV 読み込みの進め方

標準機能だけでなく、より信頼性や機能性を高めるためにCSV専用ライブラリの利用が非常に有効です。最新情報では外部ライブラリを利用することで、型変換、文化（カルチャー）対応、非同期読み込み、大量データのストリーミング処理などが手軽に実現できます。以下に主要なライブラリやその特徴を紹介します。

CsvHelperの使い方と特徴

CsvHelperは人気のあるオープンソースのライブラリで、C#でCSVの読み書きを簡単に行えるよう設計されています。カラムをオブジェクトにマッピングしたり、区切り文字や引用符・書式を柔軟に設定できます。NuGetでインストール可能で、文化設定（CultureInfo）などで国内外のフォーマットにも対応できる点が魅力です。

サンプルコードでは、StreamReaderと組み合わせてCsvReaderを使い、GetRecordsで指定のクラスに直接マッピングすることで、読み込んだCSVをそのままオブジェクトとして扱えます。複雑なCSVや型の取り扱いを意識するなら、このライブラリが第一選択になることが多いです。

IronXLで読み込み＋Excel互換操作

IronXLはCSVだけでなくExcel形式との互換性を持つライブラリで、CSVファイルを読み込んだ後にExcelワークブックとして扱う機能があります。LoadCSVメソッドで取り込み、その後セル操作やシート操作も可能なので、CSVをただ読み込むだけでなく、Excel的に加工・表示する用途に適しています。

ただしライセンス条件や商用利用時の制約があることがあるので、プロジェクト条件に応じて確認が必要です。また依存関係が多少重くなる可能性もあります。

その他の軽量ライブラリとストリーミング対応の選択肢

大量のデータを扱う場合や、メモリを節約しながら処理を行いたい場合は、軽量でストリーミング処理に対応したライブラリが便利です。例えば、大小さまざまな例外ケースに対応した読み込み機能を持つ物、非同期読み込みをサポートするものなどがあります。

こうしたライブラリでは、例として自作やコミュニティ運用の物も含め、デリミタや引用符、改行内文字、メモリ配分、速度のチューニングといった部分で差が出ます。用途に応じて選ぶことが重要です。

具体的なコード例と実践パターン

ここからは、「C# CSV ファイル 読み込み」を実際に実装する際に役立つコード例と典型的なパターンを紹介します。初心者でも試せるものから、現場で使われる応用例まで取り上げますので、自分の用途に近いものを参考にして下さい。

簡単なサンプル：1行ずつ読み込み＋Split処理

まずは基本のサンプルです。以下のパターンは、小さなCSVを扱うツールやテスト向けに最適です。ファイルを読み込んで名前と価格といった内容を処理する想定です。

using var reader = new System.IO.StreamReader("data.csv", System.Text.Encoding.UTF8);
while (!reader.EndOfStream)
{
  var line = reader.ReadLine();
  var columns = line.Split(',');
  var name = columns[0];
  var price = columns[1];
  Console.WriteLine($"{name} : {price}");
}

この処理ではUTF-8を使っていますが、日本語Windows環境などではShift_JISやUTF-8 with BOMなどの違いで文字化けが発生する可能性があります。文字コードの指定は必ず行うべきです。

引用符付き値対応：TextFieldParserを使う例

次のコードは、値にカンマが含まれるケースや引用符で囲われた文字列、空白扱いなどに対応する実装です。TextFieldParserクラスを使うことで、こうした仕様を標準的に処理できます。

using Microsoft.VisualBasic.FileIO;
using var parser = new TextFieldParser("data.csv", System.Text.Encoding.UTF8);
parser.TextFieldType = FieldType.Delimited;
parser.SetDelimiters(",");
parser.HasFieldsEnclosedInQuotes = true;
parser.TrimWhiteSpace = false;
while (!parser.EndOfData)
{
  string[] fields = parser.ReadFields();
  foreach (var f in fields)
    Console.WriteLine(f);
}

この方法なら、”値に区切り文字が入っている”、”空白が先頭尾についている”、”改行を含むフィールド”など多くのCSVの実用的要件に対応可能です。厳密なCSV仕様を扱うならこのアプローチが安全です。

オブジェクトマッピングとCsvHelper使用例

大規模プロジェクトや複数種類のデータを扱うときは、CSVの各列をクラスプロパティに対応付けて読み込む方が保守性に優れます。ここではCsvHelperでカスタム設定を使いながらマッピングする例を紹介します。

public class Person { public string FirstName { get; set; } public string LastName { get; set; } public DateTime BirthDate { get; set; } }