C#でCSVのファイルを読み込み！データを正しく取得するプログラム

CSVファイルをC#で読み込むとき、多くの人が最初に悩むのが「文字化け」「区切り文字」「ヘッダー」「複雑な値を含むフィールド」などです。この記事ではこれらの問題を網羅的に解説し、標準的な方法、ライブラリの使い方、パフォーマンスの工夫まで含めて、C#でCSVのファイルを読み込みたい人が満足できる内容を提供します。

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

C#でCSVファイルを読み込む基本的な考え方と構成要素を理解することは、後で応用的な方法や問題対応をする上で非常に重要です。ここではCSVファイルの構造、文字コード、区切り文字などの基本要素を解説します。最新情報にもとづいた内容として、.NET標準でのサポートやファイル処理のパフォーマンスについても触れます。

CSVファイルとは何か

CSVは「Comma Separated Values」の略で、各レコード（行）が文字列であり、値はカンマなどの区切り文字で区分され、改行でレコードが区切られるテキスト形式です。値そのものにカンマや改行、引用符が入ることを許す仕様で、RFC4180に準拠するケースが多いですが、必ずしも標準に完全準拠していないファイルも存在します。こういったファイルを処理する際には、標準的なフォーマットとは異なる場合があるという理解が重要です。

文字コードと文字化けの問題

CSVファイルを読み込むときの文字化けは、主にファイルが保存されている文字コードと読み込み時に指定する文字コードが一致しないことが原因です。日本語環境ではUTF‐8またはShift_JISがよく使われ、StreamReaderなどで明示的に文字コードを指定することが必要です。特に BOM の有無や改行コードの取り扱いも文字化けや余分な文字を混入させる要因になりますので注意が必要です。

区切り文字（デリミタ）とヘッダーの扱い

標準的なCSVはカンマ（,）ですが、データに応じてセミコロン（;）やタブ（t）などが使われるケースがあります。Splitメソッドを使う方法ではこれを簡単に変更できます。また、1行目にヘッダー（列名）があるCSVを読み込む場合、最初の行をスキップする処理を入れることで列名を扱いやすくなります。ヘッダー情報をクラスのプロパティ名にマッピングするケースでは、ライブラリの機能が役立ちます。

標準クラスによる C# CSV ファイル 読み込み 方法

標準のクラスやメソッドを利用して、外部ライブラリ不要でCSVのファイルを読み込む方法には複数あります。ここでは StreamReader、File.ReadLines／ReadAllLines、および Microsoft.VisualBasic.FileIO.TextFieldParser の使用例とそれぞれのメリット・注意点を詳しく解説します。

StreamReader を使う方法

StreamReader クラスを使えばファイルを一行ずつ読み込むことができます。ファイルパスと文字コードを指定しながら using ブロックで囲むことで、ファイルのクローズ忘れを防ぎます。一行を ReadLine メソッドで読み、文字列を Split メソッドで区切り文字ごとに配列へ分割します。ただし、値の中に区切り文字や引用符が含まれていると正しく処理できないことがあります。

File.ReadLines と File.ReadAllLines の比較

File.ReadAllLines はファイル全体を文字列配列として読み込むため、小さなファイルには便利ですが、大きなファイルではメモリ消費が大きくなります。一方 ReadLines は IEnumerable を返し、一行ずつ順次読み込むため、メモリ効率がよく大量データの処理に適しています。最新の .NET 環境ではこの使い分けがより重要になっています。

TextFieldParser を使う方法

TextFieldParser は Microsoft.VisualBasic.FileIO 名前空間のクラスで、区切り文字、引用符によるフィールド囲み、改行付きフィールドなど RFC4180 に近い形式を扱うことができます。特に HasFieldsEnclosedInQuotes プロパティを true に設定することで、引用符で囲まれたフィールド内のカンマを区切りとみなさず正しく処理できます。複雑なCSVを扱う際には TextFieldParser が非常に有用です。

C# CSV ファイル 読み込み におけるライブラリと応用テクニック

標準機能で対応できることは多いですが、より信頼性や機能を充実させたい場合には、外部ライブラリや応用的なコード設計を使うことが有効です。ここでは CsvHelper や正規表現、例外処理、パフォーマンスチューニングのテクニックを紹介します。

CsvHelper の利用

CsvHelper は非常に柔軟で使いやすい外部ライブラリです。マッピング機能によりクラスプロパティへ直接値を割り当てたり、区切り文字や引用符、ヘッダーの有無といったオプションを細かく設定できます。大規模なCSVを扱う場合や、データクレンジングが必要なCSVの読み込みには CsvHelper が選ばれることが多く、その設定性・メンテナンス性の高さが評価されています。

正規表現や自作パーサーによる手法

CSV の値に引用符を含む場合や、形式が少し不規則なとき、正規表現を使って区切り文字を判定する方法があります。例えば引用符で囲まれていない区切り文字だけで分割するパターンを正規表現で書くことで Split の問題を回避できます。ただし、この方法は可読性が低く、保守が困難になる可能性があるため、必要に応じて慎重に採用するべきです。

例外処理と不正フォーマット対応

CSV ファイルを読み込むときには、行の列数が異なる、引用符が閉じられていない、予期しない文字が含まれるなどの不正なフォーマットが存在することがあります。TextFieldParser の MalformedLineException をキャッチして代替処理をする、空フィールドを null に変換する、トリム処理を入れる、といった対応を用意しておくと実運用での信頼性が高まります。

パフォーマンスとメモリ管理の工夫

大量のCSVデータを処理する際には、処理速度とメモリ効率が非常に重要です。ここでは最新の環境で有効な工夫を紹介します。ファイルの読み込み方法、ストリーム処理、バッファリング、非同期読み込みなどがあります。

ストリーミングと遅延ループ処理

File.ReadLines や StreamReader を使って、逐次読み込みを行うことでメモリ使用量を抑えつつ、データ処理を開始できます。全部読み込んでから処理をする方法では、一時的に大量のメモリが必要となります。StreamReader の ReadLine と while ループを組み合わせてファイル終端まで読む方法は、多くのデータを扱う際に推奨されます。

非同期読み込みと大容量ファイル

ファイル読み込みでのブロッキングを避けるために、非同期 API を活用することも考えられます。たとえば StreamReader.ReadLineAsync やその他非同期ストリームを使うことで、UI スレッドの応答性を保ちつつ大きな CSV を処理できます。また、可能であれば並列処理やバッチ処理で分割読み込みすることで処理時間を短縮できます。

メモリ割り当ての削減

文字列の連結や大量の配列生成などは GC（ガーベジコレクション）コストやメモリ断片化を引き起こします。ReadLines や foreach などで一度に一行を扱い、必要な行だけ保持するようにすることでメモリ消費を抑えられます。また、不要な文字列のコピーや Trim、Quote の除去処理などは効率よく行うことが望ましいです。

実践：C# CSV ファイル 読み込み プログラム サンプル

ここでは実際に使えるサンプルコードを交えながら、C#でCSVのファイルを読み込み、ヘッダー処理、引用符付きフィールド、例外処理などを含む実践的なプログラムを構築する手順を解説します。実際の開発で役立つ構成を示します。

簡単なサンプル：StreamReader＋Split 方法

以下は、最も基本的なCSV読み込みサンプルです。ファイルパスと文字コードを指定し、ヘッダー行をスキップ、各行をカンマで分割して処理します。小規模・単純なCSVには十分な方法です。

using System;
using System.IO;

class Program
{
    static void Main()
    {
        string filePath = @"path/to/sample.csv";
        if (!File.Exists(filePath)) return;
        using (var reader = new StreamReader(filePath, System.Text.Encoding.UTF8))
        {
            // ヘッダー読み飛ばし
            string headerLine = reader.ReadLine();
            while (!reader.EndOfStream)
            {
                string line = reader.ReadLine();
                string[] cols = line.Split(',');
                // cols[0], cols[1] ... を使う
            }
        }
    }
}

引用符付きフィールド対応：TextFieldParser 使用例

値にカンマや改行、引用符が含まれるCSVを正しく読み込むには、TextFieldParser を利用し、HasFieldsEnclosedInQuotes を設定することが効果的です。以下はそのサンプルです。

using System;
using Microsoft.VisualBasic.FileIO;

class Program
{
    static void Main()
    {
        string filePath = @"path/to/complex.csv";
        using (var parser = new TextFieldParser(filePath, System.Text.Encoding.UTF8))
        {
            parser.SetDelimiters(new string[] { "," });
            parser.HasFieldsEnclosedInQuotes = true;
            // ヘッダー読み飛ばし
            if (!parser.EndOfData) parser.ReadFields();
            while (!parser.EndOfData)
            {
                string[] fields = parser.ReadFields();
                // フィールドごとに処理
            }
        }
    }
}

CsvHelper を使ってマッピングも含めた読み込み

CsvHelper を使うとクラスとのマッピングが簡単になります。ヘッダー行をクラスのプロパティ名に対応させ、オプションで区切り文字や引用符の設定を細かく行えます。サンプル構成は以下のとおりです。

using CsvHelper;
using System;
using System.Globalization;
using System.IO;

public class Record
{
    public string Name { get; set; }
    public int Age { get; set; }
    public string Address { get; set; }
}

class Program
{
    static void Main()
    {
        using (var reader = new StreamReader("records.csv", System.Text.Encoding.UTF8))
        using (var csv = new CsvReader(reader, CultureInfo.InvariantCulture))
        {
            csv.Configuration.HasHeaderRecord = true;
            csv.Configuration.Delimiter = ",";
            csv.Configuration.IgnoreBlankLines = true;
            var records = csv.GetRecords();
            foreach (var rec in records)
            {
                // rec.Name, rec.Age, rec.Address を使用
            }
        }
    }
}

よくあるトラブルと解決策

CSVファイル読み込み時に起こりがちなトラブルとその解決策を具体的に挙げます。実際の現場で時間を無駄にしないように、想定できる問題には事前対応できるようにしておきましょう。

列数が異なる行がある

CSVの途中で列数が少ない・多い行があると、Split や ReadFields で例外が発生する、または値が欠けたり余ったりします。こうした行を検出するために cols.Length を確認し、期待される列数と一致しない場合はスキップするか補填する処理を入れます。

空行や余分な改行が含まれる

人間が編集したCSVには、末尾に空行があったり、データの区切りで余計な改行が混じっていたりすることがあります。読み込みループの中で line が null や空文字列かどうかをチェックし、無視するロジックを入れておくと安全です。

パースできない引用符や escape の問題

引用符で囲まれるはずのフィールドで引用符が閉じられていないなど、不正なフォーマットの行が含まれることがあります。このような場合には例外をキャッチして代替処理を行うか、正規表現で補正するロジックを組み込むとよいです。TextFieldParser の設定や CsvHelper の設定の一部で malformed 行をスキップするオプションを使えるようになっているものもあります。

比較表：方法ごとの特徴と用途

複数の読み込み方法を比較し、どの方法を選ぶべきか参考になる表を示します。用途に応じて最適な方法を選ぶ助けになるでしょう。

まとめ

C#でCSVファイルを読み込むには、まずCSVファイルの形式（区切り文字・ヘッダー・値の中の引用符など）を把握することが第一歩です。基本的な方法として StreamReader＋Split があり、標準クラスだけで済ませたいときには十分役立ちます。

ただし、値にカンマや引用符、改行などを含む複雑なCSVでは TextFieldParser を使うか、より柔軟な CsvHelper のようなライブラリを利用することが望ましいです。また、巨大な CSV を扱う環境では メモリ効率や遅延読み込み、非同期処理といった性能面の工夫が重要です。

紹介したサンプルや比較表を参考に、ご自身の用途に最適な方法を選び、安定して正しくデータを取得できるプログラムを作成してください。