はじめに

本記事はC#用ライブラリの「Csv」を使い方をサンプルを交えて述べる記事です。

Csvとは

C#でCSVファイルを読み書きするためのライブラリです。かなり簡単に使えることが特徴です。
詳細はこちらを参照ください。

CSVを使ってみる

「Csv」を使うサンプルとして、以下のようなCSVデータ(ウェブページの閲覧ログのイメージ)において、ページごとのユニークユーザー数を算出してみます。

ユニークユーザー数とは重複を取り除いたユーザー数のことなので、例えば上記の製品紹介ページの場合は、ユニークユーザー数は2となります。(製品紹介ページのレコードは計5件ですが、内4件は同じユーザーID:5のユーザーなので、ユニークユーザー数としては2になります。)
では作り方を見ていきます。まずは「Csv」のインストールが必要です。VisualStudioでプロジェクトを作成し、プロジェクトを右クリックし、コンテキストメニューから「Nugetパッケージの管理」をクリックします。その後、「Csv」というNugetパッケージをインストールします。これでインストールは完了です。

次にコードを書いていきます。実際のコードは以下です。

using Csv;

// CSVファイルを文字列で取得
var csvText = File.ReadAllText("CSVファイルのパス");

// ページごとのユニークユーザーID一覧
var uniqueUserIdsPerPage = new Dictionary<string, HashSet<string>>();

// CSVファイルの各行ごとに処理をする
foreach (var line in CsvReader.ReadFromText(csvText))
{
    // [ページ名]列の値を取得
    var pageName = line["ページ名"];
    // [ユーザーID]列の値を取得
    var userId = line["ユーザーID"];
    
    if (!uniqueUserIdsPerPage.ContainsKey(pageName))
    {
        // 該当のページに対応するユーザーIDが一件も追加されていない場合はユーザーIDリストを初期化
        uniqueUserIdsPerPage.Add(pageName, new HashSet<string>() { userId });
    }
    else
    {
        // 該当のページに対応するユーザーIDを追加
        // HashSetへの追加なので重複追加はされない
        uniqueUserIdsPerPage[pageName].Add(userId);
    }
}

// ページごとのユニークユーザー数を出力
foreach (var (pageName, users) in uniqueUserIdsPerPage)
{
    Console.WriteLine($"{pageName}:{users.Count}");
}

コードの説明をしていきます。
CSVファイルの内容を文字列で取り出し、以下のforeach文でCSVの各行ごとに反復処理をします。

// CSVファイルの各行ごとに処理をする
foreach (var line in CsvReader.ReadFromText(csvText))
{
    // 各行ごとにこの処理を実施
}

foreach内部ではまず、行ごとの[ページ名]列と[ユーザーID]列の値を取得します。
上記のコード内の変数lineは「Csv」で提供するインターフェースを実装しているため、以下のように列名を使ってインデクサアクセスをすることで、その列名に対応する列の値が取得できます。

// [ページ名]列の値を取得
var pageName = line["ページ名"];
// [ユーザーID]列の値を取得
var userId = line["ユーザーID"];

次に、取得したページ名ごとにユーザーIDの値をHashSetに詰めていきます。HashSetへの登録なので、重複したユーザーIDは登録されず、この方法でデータを登録していくことで、ページごとのユニークユーザーのIDリストが作成できます。

if (!uniqueUserIdsPerPage.ContainsKey(pageName))
{
    // 該当のページに対応するユーザーIDが一件も追加されていない場合はユーザーIDリストを初期化
    uniqueUserIdsPerPage.Add(pageName, new HashSet<string>() { userId });
}
else
{
    // 該当のページに対応するユーザーIDを追加
    // HashSetへの追加なので重複追加はされない
    uniqueUserIdsPerPage[pageName].Add(userId);
}

foreachを抜けたのちに、登録した情報を使ってページ数ごとのユニークユーザーを出力します。

// ページごとのユニークユーザー数を出力
foreach (var (pageName, users) in uniqueUserIdsPerPage)
{
    Console.WriteLine($"{pageName}:{users.Count}");
}

出力結果は以下のようになります。

使ってみて感じた「Csv」の良さは、とにかく手軽に使えることだと思います。Csvのテキストから各行ごとの反復処理がすぐに書けますし、列名を指定して値を取得できるのもかなり便利だと思いました。手軽にCsvを操作したいときに役立つライブラリだと思いました。

まとめ

本記事では、C#用ライブラリの「Csv」を使い方をサンプルを交えて述べました。
とにかく手軽に使えることが「Csv」の良さだと感じたので、サクッとCSVをC#で操作したいときには使ってみることをお勧めします。

C#用ライブラリの「Csv」を使ってみる

はじめに

Csvとは

CSVを使ってみる

まとめ