C# CSVパーサーでデータ処理を簡素化する（ガイド）

基本的な文字列分割が失敗する理由

CSV ファイルを解析する最も一般的な初心者のアプローチを考えてみましょう：

string line = "John,Doe,30,Engineer";
string[] values = line.Split(','); // string array

string line = "John,Doe,30,Engineer";
string[] values = line.Split(','); // string array

これは単純なケースでは完璧に機能しますが、実際のデータに遭遇するとすぐに失敗します。 埋め込まれたコンマを含む引用符で囲まれたフィールドには、大きな問題が 1 つあります。"Smith, John",Developer,"New York, NY",50000 などの CSV 行は 4 つのフィールドではなく 5 つのフィールドに分割され、データ構造が破損し、後続の処理で不整合が発生します。

フィールド内の改行も問題の原因となります。 RFC 4180 によれば、適切に引用符で囲まれていればフィールドに改行を含めることができます。 複数行の住所フィールドは、行ごとの読み取りアプローチを中断させ、引用されたフィールド内で改行が発生したのか新しいレコードを表すのかを追跡するための洗練された状態管理を必要とします。

エスケープ文字と引用符の処理により、さらに複雑になります。 CSV ファイルでは、引用符で囲まれたフィールド内の引用符をエスケープするためにさまざまな規則が使用されます。 二重引用符 ("") を使用するものもあれば、バックスラッシュやその他のエスケープ文字を使用するものもあります。 適切に処理しないと、"She said, ""Hello!""",greeting のようなデータが破損したり、解析エラーが発生したりします。

異なる区切り文字とエンコードにより、複雑さがさらに増します。 すべての"CSV"ファイルでカンマが使用されるわけではありません。 タブ区切り値(TSV)、パイプ区切りファイル、セミコロン区切り値は一般的なバリエーションです。 RFC 4180標準はCSV形式の仕様を定義していますが、多くの実装がそれから逸脱しています。

メモリ管理は大容量ファイルの処理にどのような影響を与えますか?

File.ReadAllLines() を使用して 500 MB の CSV ファイル全体をメモリにロードすると、パフォーマンスが大幅に低下したり、メモリ不足の例外が発生する可能性があります。 数百万行を処理するには、アプリケーションの応答性を維持するために、ストリーミング アプローチと効率的なメモリ管理が必要です。

異なるソースからの CSV ファイル (それぞれ異なる規則を使用している可能性がある) を扱う場合、これらの複雑さはさらに増大します。 すべてのシナリオを確実に処理するパーサーを構築するには、多大な開発労力と、新たなエッジケースの発生に伴う継続的なメンテナンスが必要です。

インストール手順は何ですか?

NuGetパッケージ マネージャー コンソールまたは.NET CLI 経由でIronXLをインストールします。

# NuGet Package Manager Console
Install-Package IronXl.Excel

# .NET CLI
dotnet add package IronXl.Excel

# NuGet Package Manager Console
Install-Package IronXl.Excel

# .NET CLI
dotnet add package IronXl.Excel

ライセンス設定については、購入前に試用ライセンスを取得してIronXL を完全に評価することができます。

最初の CSV ファイルを読み込むにはどうすればよいでしょうか?

インストールしたら、 IronXL名前空間を C# ファイルに追加し、数行で CSV を読み込みます。

using IronXL;

// Load a CSV file using top-level statements
WorkBook workbook = WorkBook.LoadCSV("customers.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read a specific cell value
string customerName = sheet["B2"].StringValue;
Console.WriteLine($"Customer: {customerName}");

using IronXL;

// Load a CSV file using top-level statements
WorkBook workbook = WorkBook.LoadCSV("customers.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read a specific cell value
string customerName = sheet["B2"].StringValue;
Console.WriteLine($"Customer: {customerName}");

WorkBook.LoadCSV() メソッドは CSV ファイルをインテリジェントに解析し、区切り文字を自動的に検出し、引用符で囲まれたフィールドを処理します。 CSV ファイルには単一のシートが含まれているため、データには DefaultWorkSheet を介してアクセスします。 型付きアクセサー StringValue は、型セーフな値の取得を提供します。

入力

出力

CSV 行を反復処理するにはどうすればよいでしょうか?

最も直接的な方法は、デフォルト設定で LoadCSV を使用し、すべての行を反復処理します。

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("sales_data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Iterate through all data rows (skipping header at row 0)
for (var row = 1; row <= sheet.RowCount; row++)
{
    string productName = sheet[$"A{row}"].StringValue;
    decimal price = sheet[$"B{row}"].DecimalValue;
    int quantity = sheet[$"C{row}"].IntValue;
    Console.WriteLine($"Product: {productName}, Price: ${price}, Qty: {quantity}");
}

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("sales_data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Iterate through all data rows (skipping header at row 0)
for (var row = 1; row <= sheet.RowCount; row++)
{
    string productName = sheet[$"A{row}"].StringValue;
    decimal price = sheet[$"B{row}"].DecimalValue;
    int quantity = sheet[$"C{row}"].IntValue;
    Console.WriteLine($"Product: {productName}, Price: ${price}, Qty: {quantity}");
}

IronXL の型付きアクセサーは、テキストを適切な.NET型に自動的に変換し、手動での解析を排除します。 ループは、ファイル内のデータ行の合計数を正確に反映する RowCount を使用してすべての行にわたって継続されます。

非標準の区切り文字をどのように処理しますか?

非標準の区切り文字を含む CSV ファイルの場合、 IronXL はlistDelimiter パラメータを通じて構成オプションを提供します。

using IronXL;

// Load a tab-separated file
WorkBook workbook = WorkBook.LoadCSV("inventory.tsv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: "\t");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Build header list from column 0
var headers = new List<string>();
for (int col = 0; col < sheet.ColumnCount; col++)
{
    headers.Add(sheet.GetCellAt(0, col).StringValue);
}
Console.WriteLine("Columns: " + string.Join(" | ", headers));

using IronXL;

// Load a tab-separated file
WorkBook workbook = WorkBook.LoadCSV("inventory.tsv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: "\t");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Build header list from column 0
var headers = new List<string>();
for (int col = 0; col < sheet.ColumnCount; col++)
{
    headers.Add(sheet.GetCellAt(0, col).StringValue);
}
Console.WriteLine("Columns: " + string.Join(" | ", headers));

listDelimiter パラメータはフィールド区切り文字を指定します (ここでは、TSV ファイルのタブ)。 fileFormat パラメータは解析後の内部表現を決定します。 追加のファイル形式オプションについては、 Excel ファイルの読み取りについて詳しく確認してください。

IronXL は引用符で囲まれたフィールドと特殊文字をどのように処理しますか?

IronXL は、区切り文字を含む引用符で囲まれたフィールドを持つ CSV ファイルを自動的に処理します。 パーサーは CSV 標準に従い、二重引用符をエスケープ シーケンスとして扱います。

using IronXL;

// Create sample CSV with complex quoted fields
string csvContent = @"Name,翻訳内容,Price,Category
""Johnson, Mike"",""Premium keyboard with mechanical switches"",149.99,Electronics
""O'Brien, Sarah"",""Children's toy - ages 3+"",29.99,Toys";

File.WriteAllText("complex_data.csv", csvContent);

WorkBook workbook = WorkBook.LoadCSV("complex_data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

for (int row = 1; row <= sheet.RowCount; row++)
{
    string name = sheet[$"A{row}"].StringValue;
    string description = sheet[$"B{row}"].StringValue;
    Console.WriteLine($"Name: {name}");
    Console.WriteLine($"翻訳内容: {description}");
}

using IronXL;

// Create sample CSV with complex quoted fields
string csvContent = @"Name,翻訳内容,Price,Category
""Johnson, Mike"",""Premium keyboard with mechanical switches"",149.99,Electronics
""O'Brien, Sarah"",""Children's toy - ages 3+"",29.99,Toys";

File.WriteAllText("complex_data.csv", csvContent);

WorkBook workbook = WorkBook.LoadCSV("complex_data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

for (int row = 1; row <= sheet.RowCount; row++)
{
    string name = sheet[$"A{row}"].StringValue;
    string description = sheet[$"B{row}"].StringValue;
    Console.WriteLine($"Name: {name}");
    Console.WriteLine($"翻訳内容: {description}");
}

IronXL は、カンマが含まれているにもかかわらず、"Johnson, Mike" を単一のフィールドとして正しく解釈し、説明内のネストされた引用符を適切に処理します。 この自動処理により、カスタム パーサーに必要な複雑な正規表現やステート マシンが不要になります。

文字エンコードの問題はどうでしょうか?

異なる文字エンコードを扱う場合には慎重な考慮が必要です。 IronXL はさまざまなエンコードを自動的に処理し、国際文字が正しく表示されるようにします。

using IronXL;

WorkBook workbook = WorkBook.Load("international_data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

for (int row = 1; row <= sheet.RowCount; row++)
{
    string city = sheet[$"A{row}"].StringValue;
    string country = sheet[$"B{row}"].StringValue;
    // Characters like n~, u-umlaut, e-acute display correctly
    Console.WriteLine($"Location: {city}, {country}");
}

// Save with UTF-8 encoding to preserve characters
workbook.SaveAsCsv("output_utf8.csv");

using IronXL;

WorkBook workbook = WorkBook.Load("international_data.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

for (int row = 1; row <= sheet.RowCount; row++)
{
    string city = sheet[$"A{row}"].StringValue;
    string country = sheet[$"B{row}"].StringValue;
    // Characters like n~, u-umlaut, e-acute display correctly
    Console.WriteLine($"Location: {city}, {country}");
}

// Save with UTF-8 encoding to preserve characters
workbook.SaveAsCsv("output_utf8.csv");

UTF-8、UTF-16、または従来の ANSI エンコードのいずれを使用する場合でも、 IronXL は読み取り/書き込みサイクル全体を通じて文字の整合性を維持します。 CSV ファイルを保存する場合、最大限の互換性を確保するために、デフォルトで UTF-8 が使用されます。 すべての出力形式オプションについては、エクスポート ガイドを確認してください。

入力

出力

カスタム区切り文字と地域形式をどのように操作しますか?

カスタム区切り文字と地域形式には柔軟な構成が必要です。 ヨーロッパの CSV ファイルでは、区切り文字としてセミコロン、小数点としてカンマが頻繁に使用されます。

using IronXL;

// European CSV format (semicolon delimiter, comma decimal)
string europeanCsv = @"Product;Price;Quantity
Widget A;12,50;100
Gadget B;24,99;50";

File.WriteAllText("european.csv", europeanCsv);

WorkBook workbook = WorkBook.LoadCSV("european.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");
WorkSheet sheet = workbook.DefaultWorkSheet;

for (int row = 1; row <= sheet.RowCount; row++)
{
    string product = sheet[$"A{row}"].StringValue;
    string priceText = sheet[$"B{row}"].StringValue;
    decimal price = decimal.Parse(priceText.Replace(',', '.'));
    Console.WriteLine($"{product}: euro{price}");
}

using IronXL;

// European CSV format (semicolon delimiter, comma decimal)
string europeanCsv = @"Product;Price;Quantity
Widget A;12,50;100
Gadget B;24,99;50";

File.WriteAllText("european.csv", europeanCsv);

WorkBook workbook = WorkBook.LoadCSV("european.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");
WorkSheet sheet = workbook.DefaultWorkSheet;

for (int row = 1; row <= sheet.RowCount; row++)
{
    string product = sheet[$"A{row}"].StringValue;
    string priceText = sheet[$"B{row}"].StringValue;
    decimal price = decimal.Parse(priceText.Replace(',', '.'));
    Console.WriteLine($"{product}: euro{price}");
}

listDelimiter パラメータはフィールド分割を構成し、数値解析はヨーロッパの 10 進表記を .NET の想定される形式に変換します。 この柔軟性により、ソース データを変更することなく、任意の地域の CSV ファイルを処理できます。 インポート データ ガイドでは、追加のデータ インポート シナリオについて説明します。

大規模なデータセットにバッチ処理を使用する方法

バッチ処理は、大規模なデータセットを管理しやすいチャンクに分割し、メモリの過負荷を防ぎ、進行状況の追跡を可能にします。

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("large_dataset.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

int batchSize = 1000;
int totalRows = sheet.RowCount;

for (int startRow = 1; startRow <= totalRows; startRow += batchSize)
{
    int endRow = Math.Min(startRow + batchSize - 1, totalRows);
    var batchResults = new List<(string Id, decimal Amount)>();

    for (int row = startRow; row <= endRow; row++)
    {
        string id = sheet[$"A{row}"].StringValue;
        decimal amount = sheet[$"B{row}"].DecimalValue;
        batchResults.Add((id, amount));
    }

    // Save batch results to database or file
    Console.WriteLine($"Processed rows {startRow} to {endRow}: {batchResults.Count} records");
}

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("large_dataset.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

int batchSize = 1000;
int totalRows = sheet.RowCount;

for (int startRow = 1; startRow <= totalRows; startRow += batchSize)
{
    int endRow = Math.Min(startRow + batchSize - 1, totalRows);
    var batchResults = new List<(string Id, decimal Amount)>();

    for (int row = startRow; row <= endRow; row++)
    {
        string id = sheet[$"A{row}"].StringValue;
        decimal amount = sheet[$"B{row}"].DecimalValue;
        batchResults.Add((id, amount));
    }

    // Save batch results to database or file
    Console.WriteLine($"Processed rows {startRow} to {endRow}: {batchResults.Count} records");
}

一度に 1000 行を処理すると、バッチ間でガベージ コレクションが可能になり、メモリ使用量が安定します。 このパターンにより、エラー回復も容易になります。最初からやり直すのではなく、最後に成功したバッチから再開できます。 Excel から DataSet へのガイドでは、メモリ内の大量のデータを効率的に処理する方法を示します。

CSV ファイルをフォーマットされた Excel ワークブックに変換するにはどうすればよいですか?

書式設定を使用して CSV を Excel に変換すると、データの表示が強化され、数式、グラフ、スタイルなどの高度な機能が有効になります。

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("sales_report.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Format header row
for (int col = 0; col < sheet.ColumnCount; col++)
{
    var headerCell = sheet.GetCellAt(0, col);
    headerCell.Style.Font.Bold = true;
    headerCell.Style.BackgroundColor = "#4472C4";
    headerCell.Style.Font.Color = "#FFFFFF";
}

// Format currency columns
for (int row = 1; row <= sheet.RowCount; row++)
{
    var priceCell = sheet[$"C{row}"];
    priceCell.FormatString = "$#,##0.00";
}

// Auto-fit columns for better display
for (int col = 0; col < sheet.ColumnCount; col++)
{
    sheet.AutoSizeColumn(col);
}

workbook.SaveAs("formatted_report.xlsx");
Console.WriteLine("CSV converted to formatted Excel file");

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("sales_report.csv");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Format header row
for (int col = 0; col < sheet.ColumnCount; col++)
{
    var headerCell = sheet.GetCellAt(0, col);
    headerCell.Style.Font.Bold = true;
    headerCell.Style.BackgroundColor = "#4472C4";
    headerCell.Style.Font.Color = "#FFFFFF";
}

// Format currency columns
for (int row = 1; row <= sheet.RowCount; row++)
{
    var priceCell = sheet[$"C{row}"];
    priceCell.FormatString = "$#,##0.00";
}

// Auto-fit columns for better display
for (int col = 0; col < sheet.ColumnCount; col++)
{
    sheet.AutoSizeColumn(col);
}

workbook.SaveAs("formatted_report.xlsx");
Console.WriteLine("CSV converted to formatted Excel file");

コードはヘッダーに太字の書式と色を適用し、視覚的な階層を作成します。 千単位の区切りを使用した通貨書式設定により、数値の読みやすさが向上します。 AutoSizeColumn コンテンツに合わせて列幅を調整します。 セルの書式設定ガイドとExcel ファイルの書き込みチュートリアルでは、追加の書式設定テクニックが提供されます。

入力

出力

CSV データから新しい Excel ファイルを作成するにはどうすればよいですか?

IronXL を使用すると、単純な変換だけでなく、CSV ソースから複数のワークシート、数式、構造化データを含むExcel ファイルを作成できます。 セルの結合ガイドでは、結合されたヘッダーを使用してプロフェッショナルな外観のレポートを作成する方法を説明します。

コンテナー化された展開の場合、IronXL の変換機能は、外部依存関係や Office のインストールなしで Docker 環境で動作します。 そのため、軽量で自己完結型の処理が不可欠なクラウドネイティブ アーキテクチャに最適です。