# C# CsvHelperで学ぶCSVファイルの基本構造

## 目次

1. CSVファイルとは

2. CsvHelperとは

3. CsvHelperのインストール方法

4. CSVファイルの読み込み

    1. 基本的な読み込み方

    2. カスタムクラスへのマッピング

    3. ヘッダーの扱い

5. CSVファイルの書き込み

    1. 基本的な書き込み方

    2. データのフォーマット指定

6. エラーハンドリング

7. パフォーマンスの向上

8. まとめ

## 1. CSVファイルとは

CSV（Comma-Separated Values）ファイルは、データをテーブル形式で表現するためのシンプルなフォーマットです。各行が1つのデータレコードを表し、フィールドはカンマで区切られています。Excelや多くのプログラムで互換性が高く、データのインポート・エクスポートによく使われます。

## 2. CsvHelperとは

CsvHelperは、C#でCSVファイルを読み書きするための強力なライブラリです。柔軟性が高く、クラスへのマッピングやカスタム設定、パフォーマンスの面での最適化が可能です。これにより、CSVを用いたデータ操作がより簡単になります。

## 3. CsvHelperのインストール方法

CsvHelperをプロジェクトに追加する最も簡単な方法は、NuGetパッケージマネージャーを使用することです。Visual Studioで以下のコマンドを使用します。

```shell

Install-Package CsvHelper

```

## 4. CSVファイルの読み込み

### 4-1. 基本的な読み込み方

CsvHelperを使用してCSVファイルを読み込むには、まず`CsvReader`クラスを使用します。以下に基本的な例を示します。

```csharp

using CsvHelper;

using System.Globalization;

using System.IO;

using (var reader = new StreamReader("sample.csv"))

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

{

    var records = csv.GetRecords<dynamic>();

    foreach (var record in records)

    {

        Console.WriteLine(record.Field);

    }

}

```

### 4-2. カスタムクラスへのマッピング

CSVファイルのデータを特定のクラスにマップすることで、より扱いやすくすることが可能です。例えば、以下のようにしてクラスへマッピングします。

```csharp

public class SampleRecord

{

    public string Name { get; set; }

    public int Age { get; set; }

}

using (var reader = new StreamReader("sample.csv"))

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

{

    var records = csv.GetRecords<SampleRecord>().ToList();

    foreach (var record in records)

    {

        Console.WriteLine($"{record.Name} is {record.Age} years old.");

    }

}

```

### 4-3. ヘッダーの扱い

CSVファイルにヘッダーが含まれていない場合、明示的にヘッダーを設定できます。

```csharp

csv.Configuration.HasHeaderRecord = false;

csv.Configuration.RegisterClassMap<SampleRecordMap>();

public class SampleRecordMap : ClassMap<SampleRecord>

{

    public SampleRecordMap()

    {

        Map(m => m.Name).Index(0);

        Map(m => m.Age).Index(1);

    }

}

```

## 5. CSVファイルの書き込み

### 5-1. 基本的な書き込み方

CSVファイルへの書き込みも簡単です。以下の例ではクラスのリストからCSVファイルに書き込んでいます。

```csharp

using (var writer = new StreamWriter("output.csv"))

using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))

{

    var records = new List<SampleRecord>

    {

        new SampleRecord { Name = "John Doe", Age = 30 },

        new SampleRecord { Name = "Jane Doe", Age = 25 }

    };

    csv.WriteRecords(records);

}

```

### 5-2. データのフォーマット指定

特定のデータフォーマットを指定してCSVに出力することも可能です。たとえば、日付のフォーマットを指定したい場合は以下のように設定します。

```csharp

csv.Configuration.RegisterClassMap<SampleRecordMap>();

public class SampleRecordMap : ClassMap<SampleRecord>

{

    public SampleRecordMap()

    {

        Map(m => m.BirthDate).TypeConverterOption.Format("yyyyMMdd");

    }

}

```

## 6. エラーハンドリング

エラーハンドリングには注意が必要です。特にデータの不整合やフォーマットの不一致が起こることがあります。`Exception`をキャッチして、適切にログを出力することが推奨されます。

```csharp

try

{

    // CSVの読み込み処理

}

catch (Exception ex)

{

    Console.WriteLine($"Error: {ex.Message}");

}

```

## 7. パフォーマンスの向上

大量のデータを扱う場合、パフォーマンスに影響を及ぼす可能性があります。CsvHelperは並列処理やバッファサイズの調整をサポートしており、これを最適化することでパフォーマンスが向上します。

- **バッファサイズの調整**: `StreamReader`のバッファサイズを上げると、I/Oパフォーマンスが向上することがあります。

- **並列処理**: 大きなファイルの読み込みでは、データの分割処理が有効です。

## 8. まとめ

CsvHelperは、CSVファイルの扱いを格段に容易にしてくれるC#のライブラリです。基本的な読み書きから、高度なカスタマイズ、エラーハンドリング、パフォーマンスチューニングに至るまで支援しています。用途に応じた最適な設定を行うことで、プロジェクトの効率化が図れるでしょう。

今回は基本的な使用方法を紹介しましたが、公式ドキュメントを参照することでさらに高度な使い方を学習することが可能です。

C# CsvHelperで学ぶCSVファイルの基本構造

目次

続きを読むには単価診断を受けてください（30秒）