コンマ区切り値（CSV）ファイルは、表形式のデータを保存するための遍在的なフォーマットです。そのシンプルさから容易にアクセスできますが、プログラムで処理するには慎重な検討が必要です。この記事では、C#でCSVファイルにデータを書き込む2つの異なるアプローチについて説明します。堅牢なCsvHelperライブラリを活用する方法と、組み込みのFile.WriteAllText()メソッドを使用する方法です。それぞれのアプローチは独自の利点を提供するため、最適な選択はデータの複雑さとプロジェクトの要件によって異なります。
目次
CsvHelperを使用したCSVへの書き込み
CsvHelperライブラリは、C#でCSVファイルを処理するための強力で柔軟なソリューションを提供します。引用符、エスケープ、およびさまざまな区切り文字の効率的な管理により、複雑なデータセットに最適です。お好みのパッケージマネージャー（例：Visual StudioのNuGetパッケージマネージャー）を使用して、CsvHelper NuGetパッケージをインストールしてください。
using CsvHelper;
using CsvHelper.Configuration;
using System;
using System.Globalization;
using System.IO;
using System.Collections.Generic;
public class Person
{
public string FirstName { get; set; }
public string LastName { get; set; }
public int Age { get; set; }
}
public class CsvHelperExample
{
public static void Main(string[] args)
{
List<Person> people = new List<Person>()
{
new Person { FirstName = "John", LastName = "Doe", Age = 30 },
new Person { FirstName = "Jane", LastName = "Doe", Age = 25 },
new Person { FirstName = "Peter", LastName = "Jones", Age = 40 }
};
string filePath = "output.csv";
using (var writer = new StreamWriter(filePath))
using (var csv = new CsvWriter(writer, CultureInfo.InvariantCulture))
{
csv.WriteRecords(people);
}
Console.WriteLine($"Data written to {filePath}");
}
}
この例は、PersonオブジェクトのリストをCSVファイルに書き込むことのシンプルさを示しています。CultureInfo.InvariantCultureは、システム設定に関係なく一貫したフォーマットを保証します。usingステートメントは、適切なリソースの破棄を保証します。
WriteAllText()を使用したCSVへの書き込み
より小さく、それほど複雑ではないデータセットの場合、File.WriteAllText()メソッドは簡単なアプローチを提供します。ただし、このメソッドではコンマと引用符を手動で処理する必要があり、フィールド内にこれらの文字が含まれるデータでは面倒になる可能性があります。
using System;
using System.IO;
using System.Text;
public class WriteAllTextExample
{
public static void Main(string[] args)
{
string[,] data = {
{"FirstName", "LastName", "Age"},
{"John", "Doe", "30"},
{"Jane", "Doe", "25"},
{"Peter", "Jones", "40"}
};
StringBuilder csvBuilder = new StringBuilder();
for (int i = 0; i < data.GetLength(0); i++)
{
for (int j = 0; j < data.GetLength(1); j++)
{
csvBuilder.Append(data[i, j]);
if (j < data.GetLength(1) - 1)
{
csvBuilder.Append(",");
}
}
csvBuilder.AppendLine();
}
string filePath = "output_simple.csv";
File.WriteAllText(filePath, csvBuilder.ToString());
Console.WriteLine($"Data written to {filePath}");
}
}
このコードはCSV文字列を手動で構築し、ファイルに書き込みます。単純なケースでは機能しますが、複雑なデータに対してはCsvHelperの堅牢性に欠け、データの破損を防ぐために特殊文字の広範な処理が必要です。
適切なメソッドの選択
これらのメソッドの選択は、プロジェクトの特定のニーズに完全に依存します。フィールド内に特殊文字が含まれる可能性のある、大規模または複雑なデータセットの場合、その堅牢なエラー処理と効率的なデータ管理により、CsvHelperを強くお勧めします。非常に単純なデータセットの場合、File.WriteAllText()で十分かもしれませんが、その制限を慎重に検討する必要があります。本番環境では、IOExceptionなどの潜在的な例外を管理するために、常に適切なエラー処理（例：try-catchブロック）を組み込むことを忘れないでください。