# 目次

1. はじめに

2. CsvHelperとは

3. CsvHelperのインストール

4. 基本的なCSVファイルの読み込み

   - 4.1. データモデルとマッピング

   - 4.2. CsvReaderを使ったデータの読み込み

5. 高度な機能

   - 5.1. ヘッダーのカスタマイズ

   - 5.2. 型変換とカスタムコンバーター

   - 5.3. 非同期読み込み

6. エラーハンドリング

7. パフォーマンスのベストプラクティス

8. まとめ

# 1. はじめに

CSVファイルは、データ交換のためによく使われるフォーマットの一つです。C#でCSVファイルを効率よく扱うために、C#のライブラリ「CsvHelper」を使うことが推奨されます。本記事では、CsvHelperを使ってCSVファイルを効率よく読み込む方法を詳しく解説します。

# 2. CsvHelperとは

CsvHelperは、C#および.NETでCSVファイルを読み書きするための強力なライブラリです。シンプルかつ柔軟なAPIを提供しており、CSVファイルのデータを直感的かつ効率的に操作できます。

# 3. CsvHelperのインストール

まず、CsvHelperをプロジェクトにインストールする必要があります。NuGetパッケージマネージャーを使用して、以下のコマンドでインストールが可能です。

```bash

Install-Package CsvHelper

```

# 4. 基本的なCSVファイルの読み込み

## 4.1. データモデルとマッピング

CSVファイルを読み込むためには、データモデルを定義します。例えば、以下のような「Product」というモデルクラスを用意します。

```csharp

public class Product

{

    public string Name { get; set; }

    public decimal Price { get; set; }

    public int Stock { get; set; }

}

```

CSVファイルのカラムとクラスをマッピングします。必要に応じて、カラム名を属性で指定できます。

```csharp

public class ProductMap : ClassMap<Product>

{

    public ProductMap()

    {

        Map(m => m.Name).Name("ProductName");

        Map(m => m.Price).Name("ProductPrice");

        Map(m => m.Stock).Name("ProductStock");

    }

}

```

## 4.2. CsvReaderを使ったデータの読み込み

CsvReaderを使ってCSVファイルを読み込みます。

```csharp

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

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

{

    csv.Context.RegisterClassMap<ProductMap>();

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

}

```

# 5. 高度な機能

## 5.1. ヘッダーのカスタマイズ

CSVファイルのヘッダーがない場合や異なる場合のカスタマイズも可能です。

```csharp

csv.Configuration.HasHeaderRecord = false;

csv.Configuration.RegisterClassMap<ProductMap>();

```

## 5.2. 型変換とカスタムコンバーター

独自の型変換が必要な場合、カスタムコンバーターを作成できます。

```csharp

public class CustomBoolConverter : BooleanConverter

{

    public override object ConvertFromString(string text, IReaderRow row, MemberMapData memberMapData)

    {

        if (text.Equals("Yes", StringComparison.OrdinalIgnoreCase))

        {

            return true;

        }

        return false;

    }

}

```

```csharp

public class CustomProductMap : ClassMap<Product>

{

    public CustomProductMap()

    {

        Map(m => m.InStock).ConvertUsing(row => row.GetField("InStock") == "Yes");

    }

}

```

## 5.3. 非同期読み込み

非同期にCSVを読み込むことも可能です。大規模データに便利な方法です。

```csharp

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

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

{

    csv.Context.RegisterClassMap<ProductMap>();

    var records = await csv.GetRecordsAsync<Product>().ToListAsync();

}

```

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

CsvHelperでは、エラーハンドリングを行うために、ReadingExceptionOccurredイベントを使用できます。

```csharp

csv.Configuration.ReadingExceptionOccurred = ex =>

{

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

    return false; // false to stop reading

};

```

# 7. パフォーマンスのベストプラクティス

- **バルク読み込み**: 非同期処理を活用し、効率的に大きなファイルを扱います。

- **再利用可能なストリーム**: 異なるスコープで同じストリームを使用することで、メモリ使用量を抑えることができます。

# 8. まとめ

CsvHelperを使ってCSVファイルを効率よく読み込む方法には多くの選択肢があります。基本的な読み込みから高度なマッピング機能、非同期処理まで、幅広い機能を備えているCsvHelperを活用することで、C#の開発が大幅に効率化されるでしょう。ぜひ、プロジェクトで活用してみてください。

目次

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