IronXLを使用して C# で CSV ファイルを高速に読み取るにはどうすればよいでしょうか?

IronXLを使用して C# で CSV ファイルを高速に読み取るにはどうすればよいでしょうか?

IronXL を使用すると、わずか数行のコードでコンマ区切りのデータをクエリ可能なワークブックに変換する.NETライブラリにより、C# で CSV ファイルを高速に読み取るのが簡単になります。 WorkBook.LoadCSV を呼び出してワークシートにアクセスし、行の反復処理を開始します。StreamReader の定型句や手動の分割ロジック、Office のインストールは必要ありません。

IronXLをインストールして始めるにはどうすればいいですか?

CSV データをロードする前に、 NuGetを通じてIronXL をプロジェクトに追加します。 プロジェクト ディレクトリでパッケージ マネージャー コンソールまたはターミナルを開き、次のいずれかのコマンドを実行します。

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

インストール後、CSV データを読み書きするファイルの先頭に using IronXL; を追加します。 IronXL は.NET 10 およびすべての最新 for .NETバージョンをターゲットにしているため、追加のランタイム構成は必要ありません。 パッケージには必要なものがすべて含まれています。個別のネイティブ バイナリ、プラットフォーム SDK、構成ファイルはありません。 プロジェクト ファイルで <PackageReference Include="IronXL" .../> エントリを確認することで、インストールが成功したことを確認できます。

CSV 処理以外にライブラリで何ができるかの概要については、 IronXL の機能ページとNuGetパッケージの一覧を参照してください。

C# で CSV ファイルを読み込んで読み取るにはどうすればよいでしょうか?

CSV データを読み取るための最も速いパスは、WorkBook.LoadCSV メソッドから始まります。 この 1 回の呼び出しで、ファイルの読み込みが処理され、各行が解析され、データ アクセスの準備が整った完全に機能するワークブック オブジェクトが返されます。これは、手動で StreamReader を作成し、各行を自分で処理するのとは異なります。

using IronXL;

// Load CSV file directly into a workbook
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", file形式: ExcelFile形式.XLSX);

// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read specific cell values using Excel-style addressing
string customerName = sheet["A2"].StringValue;
decimal orderTotal = sheet["D2"].DecimalValue;

// Iterate through all data rows
foreach (var row in sheet.Rows)
{
    Console.WriteLine($"Row {row.RowNumber}: {row.Columns[0].Value}");
}

using IronXL;

// Load CSV file directly into a workbook
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", file形式: ExcelFile形式.XLSX);

// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read specific cell values using Excel-style addressing
string customerName = sheet["A2"].StringValue;
decimal orderTotal = sheet["D2"].DecimalValue;

// Iterate through all data rows
foreach (var row in sheet.Rows)
{
    Console.WriteLine($"Row {row.RowNumber}: {row.Columns[0].Value}");
}

LoadCSV メソッドは、ファイル名とオプションの形式指定を受け入れ、コンマ区切り文字を自動的に検出し、各フィールド値を対応するセルに解析します。 パーサーはデフォルトで最初の行をヘッダー データとして扱い、列名に名前ですぐにアクセスできるようにします。

異なる CSV 区切り文字をどのように処理しますか?

実際のCSVファイルが単一の標準に従うことはほとんどありません。 欧州のシステムでは、区切り文字としてセミコロンがよく使用され(カンマは小数点以下の区切り文字として機能するため)、タブ区切り値(TSV)ファイルは科学的なアプリケーションやレガシーアプリケーションで一般的です。 IronXL は、listDelimiter パラメータを通じてこれらのバリエーションを処理し、任意の文字または文字列を区切り文字としてサポートします。

using IronXL;

// Load semicolon-delimited CSV (common in European formats)
WorkBook europeanData = WorkBook.LoadCSV("german_report.csv",
    file形式: ExcelFile形式.XLSX,
    listDelimiter: ";");

// Load tab-separated values file
WorkBook tsvData = WorkBook.LoadCSV("research_data.tsv",
    file形式: ExcelFile形式.XLSX,
    listDelimiter: "\t");

// Load pipe-delimited file (common in legacy systems)
WorkBook pipeData = WorkBook.LoadCSV("legacy_export.csv",
    file形式: ExcelFile形式.XLSX,
    listDelimiter: "|");

// Access data identically regardless of original delimiter
WorkSheet sheet = europeanData.DefaultWorkSheet;
Console.WriteLine($"First value: {sheet["A1"].Value}");

using IronXL;

// Load semicolon-delimited CSV (common in European formats)
WorkBook europeanData = WorkBook.LoadCSV("german_report.csv",
    file形式: ExcelFile形式.XLSX,
    listDelimiter: ";");

// Load tab-separated values file
WorkBook tsvData = WorkBook.LoadCSV("research_data.tsv",
    file形式: ExcelFile形式.XLSX,
    listDelimiter: "\t");

// Load pipe-delimited file (common in legacy systems)
WorkBook pipeData = WorkBook.LoadCSV("legacy_export.csv",
    file形式: ExcelFile形式.XLSX,
    listDelimiter: "|");

// Access data identically regardless of original delimiter
WorkSheet sheet = europeanData.DefaultWorkSheet;
Console.WriteLine($"First value: {sheet["A1"].Value}");

listDelimiter パラメータは任意の文字列値を受け入れるため、事実上あらゆる区切り文字またはシーケンスに柔軟性を提供します。 一度読み込まれたデータは、元のファイル形式に関係なく同じAPIからアクセスできるため、多様なデータソース間で一貫した開発体験が得られます。

CSV データを DataTable に変換するにはどうすればよいでしょうか?

データベース操作では、一括挿入、LINQ クエリ、またはデータ対応コントロールへのバインドのために、DataTable 形式の CSV データが頻繁に必要になります。 ToDataTable メソッドは、1 回の呼び出しでワークシート データを直接 System.Data.DataTable オブジェクトに変換するため、リストまたは配列構造を手動で作成する必要がなくなります。

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFile形式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Convert worksheet to DataTable (first row becomes column headers)
DataTable customerTable = sheet.ToDataTable(true);

// Access data using standard DataTable operations
foreach (DataRow row in customerTable.Rows)
{
    Console.WriteLine($"Customer: {row["Name"]}, Email: {row["Email"]}");
}

// Use with LINQ for filtering and transformation
var activeCustomers = customerTable.AsEnumerable()
    .Where(r => r.Field<string>("Status") == "Active")
    .ToList();

int totalCount = customerTable.Rows.Count;
Console.WriteLine($"Processed {totalCount} customer records");

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFile形式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Convert worksheet to DataTable (first row becomes column headers)
DataTable customerTable = sheet.ToDataTable(true);

// Access data using standard DataTable operations
foreach (DataRow row in customerTable.Rows)
{
    Console.WriteLine($"Customer: {row["Name"]}, Email: {row["Email"]}");
}

// Use with LINQ for filtering and transformation
var activeCustomers = customerTable.AsEnumerable()
    .Where(r => r.Field<string>("Status") == "Active")
    .ToList();

int totalCount = customerTable.Rows.Count;
Console.WriteLine($"Processed {totalCount} customer records");

ToDataTable メソッドは、ワークシートの列を DataTable 列に自動的にマッピングします。 useFirstRowAsColumnHeaders を true に設定すると、最初の行の値が列名になり、インデックスではなく名前によるフィールド アクセスが可能になります。 DataTable は、高パフォーマンスの SQL Server 挿入のために SqlBulkCopy と直接統合するか、即時視覚化のために DataGridView コントロールにバインドすることもできます。

変換は可能な限りデータ型を保持し、IronXLは基礎となるセルの値から数値、日付、テキスト型を推測します。 この自動型推論は、生のCSV文字列を扱う際に通常必要とされる手作業による解析作業を軽減します。 使い慣れた DataTable API により、データベース クエリ結果を処理する既存のコードは変更せずに CSV データを処理できるため、移行プロジェクト中に大幅な時間を節約できます。

CSV ファイルを Excel 形式に変換するにはどうすればよいですか?

IronXL の主な機能の 1 つは、CSV ファイルと Excel ファイル間の形式変換です。 CSV データは、書式設定、数式、複数のワークシートを使用して拡張し、適切な Excel ワークブックとして保存できます。これらはすべて同じコードベース内で行えます。 セルのスタイル設定オプションと数式の編集の詳細については、 IronXL のドキュメントで各機能の詳細が説明されています。

using IronXL;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly_sales.csv", ExcelFile形式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Add formatting to make the data presentable
sheet["A1:D1"].Style.Font.Bold = true;
sheet["A1:D1"].Style.SetBackgroundColor("#4472C4");

// Add a formula to calculate totals
sheet["E2"].Formula = "=SUM(B2:D2)";

// Save as Excel format
workbook.SaveAs("quarterly_sales_formatted.xlsx");

// Or save back to CSV when needed
workbook.SaveAsCsv("quarterly_sales_processed.csv");

using IronXL;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly_sales.csv", ExcelFile形式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Add formatting to make the data presentable
sheet["A1:D1"].Style.Font.Bold = true;
sheet["A1:D1"].Style.SetBackgroundColor("#4472C4");

// Add a formula to calculate totals
sheet["E2"].Formula = "=SUM(B2:D2)";

// Save as Excel format
workbook.SaveAs("quarterly_sales_formatted.xlsx");

// Or save back to CSV when needed
workbook.SaveAsCsv("quarterly_sales_processed.csv");

SaveAs メソッドは、ファイル拡張子から出力形式を決定し、XLSX、XLS、CSV、TSV、JSON、および XML エクスポートをサポートします。 この柔軟性により、単一のインポート プロセスで複数の出力チャネル (管理用の Excel レポートと下流システム用の CSV 抽出など) にデータを送信できます。 背景とパターンのカラー ガイドには、利用可能なスタイル オプションの全範囲が表示されます。

大きな CSV ファイルを効率的に処理するにはどうすればよいでしょうか?

数十万行の CSV ファイルを処理するには、慎重なメモリ管理が必要です。 IronXL は、簡単な API を維持しながら大規模なデータセットを処理するための実用的なアプローチを提供します。 推奨されるパターンは、すべてのレコードを同時にロードして変換するのではなく、データをバッチで処理することです。これにより、アクティブなメモリの使用が制御されます。

using IronXL;

// Load large CSV file
WorkBook workbook = WorkBook.LoadCSV("large_dataset.csv", ExcelFile形式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Process data in manageable chunks using range selection
int batchSize = 10000;
int totalRows = sheet.RowCount;

for (int i = 1; i <= totalRows; i += batchSize)
{
    int endRow = Math.Min(i + batchSize - 1, totalRows);

    // Select a range of rows for processing
    var batch = sheet[$"A{i}:Z{endRow}"];
    foreach (var cell in batch)
    {
        ProcessRecord(cell.Value);
    }

    // Release memory between batches for very large files
    GC.Collect();
}

// Alternative: Process row by row for maximum control
for (int i = 0; i < sheet.RowCount; i++)
{
    var row = sheet.Rows[i];
    // Process individual row data
}

using IronXL;

// Load large CSV file
WorkBook workbook = WorkBook.LoadCSV("large_dataset.csv", ExcelFile形式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// Process data in manageable chunks using range selection
int batchSize = 10000;
int totalRows = sheet.RowCount;

for (int i = 1; i <= totalRows; i += batchSize)
{
    int endRow = Math.Min(i + batchSize - 1, totalRows);

    // Select a range of rows for processing
    var batch = sheet[$"A{i}:Z{endRow}"];
    foreach (var cell in batch)
    {
        ProcessRecord(cell.Value);
    }

    // Release memory between batches for very large files
    GC.Collect();
}

// Alternative: Process row by row for maximum control
for (int i = 0; i < sheet.RowCount; i++)
{
    var row = sheet.Rows[i];
    // Process individual row data
}

このバッチ処理パターンにより、すべてのレコードを同時に処理しようとせずに、大きなファイルを体系的に処理することができます。 範囲選択構文($"A{i}:Z{endRow}") を使用すると、特定の行範囲に効率的にアクセスできます。

CSV 処理をクロスプラットフォームで実行するにはどうすればよいですか?

最新 for .NET開発は、Windows サーバー、Linux コンテナー、macOS 開発マシン、クラウド プラットフォームなど、複数の展開環境にまたがっています。 IronXLは、プラットフォーム固有のコードパスや条件付きコンパイルなしに、これらすべての環境で一貫して動作します。

using IronXL;

// This code runs identically on Windows, Linux, macOS, Docker, Azure, and AWS
WorkBook workbook = WorkBook.LoadCSV("data.csv", ExcelFile形式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// プラットフォーム-agnostic file operations
string outputPath = Path.Combine(Environment.CurrentDirectory, "output.xlsx");
workbook.SaveAs(outputPath);

Console.WriteLine($"Processed on: {Environment.OSVersion.プラットフォーム}");
Console.WriteLine($"Output saved to: {outputPath}");

bool success = File.Exists(outputPath);

using IronXL;

// This code runs identically on Windows, Linux, macOS, Docker, Azure, and AWS
WorkBook workbook = WorkBook.LoadCSV("data.csv", ExcelFile形式.XLSX);
WorkSheet sheet = workbook.DefaultWorkSheet;

// プラットフォーム-agnostic file operations
string outputPath = Path.Combine(Environment.CurrentDirectory, "output.xlsx");
workbook.SaveAs(outputPath);

Console.WriteLine($"Processed on: {Environment.OSVersion.プラットフォーム}");
Console.WriteLine($"Output saved to: {outputPath}");

bool success = File.Exists(outputPath);

同じバイナリ パッケージが、オペレーティング システムや展開モデル間で動作します。 以下の表は、サポートされているプラ​​ットフォームをまとめたものです。

このクロスプラットフォーム機能により、コードが開発からステージング、そして本番環境に移行する際に"自分のマシンでは動作する"という問題が解消されます。 Windowsワークステーションで開発されたCSV処理ルーチンは、修正なしでLinux Dockerコンテナにデプロイされます。 展開構成のガイダンスについては、 Microsoft .NET展開ドキュメントで各プラットフォームの公開戦略について説明しています。

次のステップは何ですか?

C# で CSV ファイルを読み取る場合、パフォーマンスのためにコードの明瞭さを犠牲にしたり、複雑な構成を処理したりする必要はありません。 IronXL は、解析、型変換、データ アクセスを自動的に処理する一貫した API を提供し、単純なコンマ区切りのエクスポートからヨーロッパのセミコロンで区切られた形式、タブで区切られた科学データまで、実際の CSV のさまざまなバリエーションをサポートします。

実稼働環境でIronXLを使い始めるには、 IronXLライセンスを購入して、優先サポート、1 年間のアップデート、ロイヤリティフリーの展開など、すべての機能を利用できるようにします。 価格帯は、個人の開発者、小規模チーム、エンタープライズ プロジェクト向けに用意されています。

コミットする前にIronXLを評価したい場合は、無料試用ライセンスを使用すると、評価期間中に透かしや行制限なしですべての機能をテストできます。 IronXLチュートリアル ライブラリには、一般的な CSV および Excel シナリオを網羅したガイド付きの例が用意されています。

暗号化されたCSVファイルの処理、非標準エンコードの処理、クラウドストレージプロバイダーとの統合など、特定のユースケースに関するご質問は、 Iron Softwareサポートチームとコミュニティフォーラムがご対応いたします。Microsoft Learnが提供する追加 for .NETデータ処理リソースでは、 IronXLと連携して動作するファイル入出力パターンに関する補足的な情報を提供しています。