C#でIronXLを使ってCSVファイルを読み込む方法

.NETでCSVファイルを読む最も簡単な方法は何ですか?

最も簡単な方法は、 WorkBook.LoadCSVを使用して CSV データをワークブック構造に直接インポートすることです。 この単一のメソッドは、解析、区切り文字の検出、およびデータの編成を自動的に処理します。StreamReader を作成したり、各文字列行を手動で処理したりする必要はありません。

IronXLはVisual StudioのNuGetパッケージマネージャーコンソールからインストールしてください。 .NET プロジェクトを開いて実行してください：

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

using IronXL;

// Load CSV file into a workbook with one method call
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;
// Display all rows and CSV columns
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

using IronXL;

// Load CSV file into a workbook with one method call
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
// Access the default worksheet containing CSV data
WorkSheet sheet = workbook.DefaultWorkSheet;
// Display all rows and CSV columns
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

手動 CSV 構文解析とライブラリの使用はどのように比較されますか?

IronXL が排除する複雑さを理解すると、その価値が明確になります。 手作業によるCSVの解析では、単純に見えてすぐに問題となる複数のエッジケースを、どのようなプロジェクトでも処理する必要があります。

using System.IO;

// Manual approach -- requires extensive code for basic functionality
string path = "data.csv";
string[] lines = File.ReadAllLines(path);
foreach (string line in lines)
{
    // This breaks when CSV fields contain commas inside quotes
    string[] fields = line.Split(',');
    foreach (string field in fields)
    {
        Console.Write(field.Trim() + "\t");
    }
    Console.WriteLine();
}

using System.IO;

// Manual approach -- requires extensive code for basic functionality
string path = "data.csv";
string[] lines = File.ReadAllLines(path);
foreach (string line in lines)
{
    // This breaks when CSV fields contain commas inside quotes
    string[] fields = line.Split(',');
    foreach (string field in fields)
    {
        Console.Write(field.Trim() + "\t");
    }
    Console.WriteLine();
}

using IronXL;

// IronXL approach -- handles all edge cases automatically
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
var records = workbook.DefaultWorkSheet.Rows;
foreach (var row in records)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

using IronXL;

// IronXL approach -- handles all edge cases automatically
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ",");
var records = workbook.DefaultWorkSheet.Rows;
foreach (var row in records)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Value + "\t");
    }
    Console.WriteLine();
}

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

CSV ファイルでは、区切り文字として必ずしもカンマが使用されるわけではありません。 ヨーロッパのシステムエクスポートでは、小数点にコンマが表示されるため、セミコロンが頻繁に使用されます。 タブ区切り値 (TSV) とパイプ区切りファイルは、さまざまなアプリケーションやレガシー システムからのデータ エクスポートで頻繁に使用されます。

using IronXL;

// Reading a semicolon-delimited file (common in European exports)
WorkBook euroData = WorkBook.LoadCSV("german_report.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ";");
// Reading a tab-separated file
WorkBook tsvData = WorkBook.LoadCSV("exported_data.tsv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "\t");
// Reading a pipe-delimited file
WorkBook pipeData = WorkBook.LoadCSV("legacy_system.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "|");
// Access data identically regardless of original delimiter
WorkSheet sheet = euroData.DefaultWorkSheet;
int rowsCount = sheet.RowCount;
Console.WriteLine($"Loaded {rowsCount} rows with {sheet.ColumnCount} CSV columns");

using IronXL;

// Reading a semicolon-delimited file (common in European exports)
WorkBook euroData = WorkBook.LoadCSV("german_report.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: ";");
// Reading a tab-separated file
WorkBook tsvData = WorkBook.LoadCSV("exported_data.tsv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "\t");
// Reading a pipe-delimited file
WorkBook pipeData = WorkBook.LoadCSV("legacy_system.csv", fileFormat: ExcelFileFormat.XLSX, listDelimiter: "|");
// Access data identically regardless of original delimiter
WorkSheet sheet = euroData.DefaultWorkSheet;
int rowsCount = sheet.RowCount;
Console.WriteLine($"Loaded {rowsCount} rows with {sheet.ColumnCount} CSV columns");

LoadCSV の listDelimiter パラメータは、フィールド区切り文字として任意の 1 文字またはエスケープ シーケンスを受け入れます。 タブ文字は \t エスケープ シーケンスを使用します。 ロード後、データ構造は元の形式に関係なく一貫性を保つため、区切り文字が異なる複数のソースからのCSVファイルを簡単に処理できます。 ほとんどの CSV ファイルのデフォルト値はコンマですが、この柔軟性により、プロジェクトで発生するあらゆるバリエーションに対応できます。

CSVをDataTableに変換する最良の方法は何ですか?

CSV データを DataTable に変換すると、データベース操作、UI アプリケーションでのデータ バインディング、LINQ クエリとの統合が可能になります。 ToDataTableメソッドは、1 回の呼び出しでこの変換を実行します。

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Convert worksheet to DataTable -- true parameter uses CSV header as column names
DataTable dataTable = sheet.ToDataTable(true);
// DataTable is now ready for database operations, binding, or LINQ queries
Console.WriteLine($"DataTable created with {dataTable.Columns.Count} columns:");
foreach (DataColumn column in dataTable.Columns)
{
    // Property names from CSV header become column names
    Console.WriteLine($"  - {column.ColumnName}");
}
Console.WriteLine($"\nTotal records: {dataTable.Rows.Count}");
// Access data using standard DataTable syntax
foreach (DataRow row in dataTable.Rows)
{
    // Access by column index or name attribute
    string name = row["Name"].ToString();
    string email = row["Email"].ToString();
    Console.WriteLine($"Customer: {name}, Email: {email}");
}

using IronXL;
using System.Data;

// Load CSV and convert to DataTable
WorkBook workbook = WorkBook.LoadCSV("customers.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Convert worksheet to DataTable -- true parameter uses CSV header as column names
DataTable dataTable = sheet.ToDataTable(true);
// DataTable is now ready for database operations, binding, or LINQ queries
Console.WriteLine($"DataTable created with {dataTable.Columns.Count} columns:");
foreach (DataColumn column in dataTable.Columns)
{
    // Property names from CSV header become column names
    Console.WriteLine($"  - {column.ColumnName}");
}
Console.WriteLine($"\nTotal records: {dataTable.Rows.Count}");
// Access data using standard DataTable syntax
foreach (DataRow row in dataTable.Rows)
{
    // Access by column index or name attribute
    string name = row["Name"].ToString();
    string email = row["Email"].ToString();
    Console.WriteLine($"Customer: {name}, Email: {email}");
}

ToDataTable のブールパラメータは、最初の行を列ヘッダー (true) にするか、データ (false) にするかを決定します。 true に設定すると、結果の DataTable の列には CSV ファイルのヘッダー名が保持され、row["Name"] のような列名を使用して直感的なデータ アクセスが可能になります。

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

IronXLの特筆すべき機能の一つは、CSVデータを適切なExcel形式に変換することです。 これにより、元々フラットな CSV データに数式、書式設定、グラフ、複数のワークシートを追加できるようになります。これは、CSV 出力だけでは実現できないことです。

using IronXL;

// Load CSV data from file path
string path = "quarterly_sales.csv";
WorkBook workbook = WorkBook.LoadCSV(path, ExcelFileFormat.XLSX, ",");
// Save as Excel XLSX format -- creates a new Excel file
workbook.SaveAs("quarterly_sales.xlsx");
// Alternative: Save as legacy XLS format for older Excel versions
workbook.SaveAs("quarterly_sales.xls");
Console.WriteLine("CSV successfully converted to Excel format");

using IronXL;

// Load CSV data from file path
string path = "quarterly_sales.csv";
WorkBook workbook = WorkBook.LoadCSV(path, ExcelFileFormat.XLSX, ",");
// Save as Excel XLSX format -- creates a new Excel file
workbook.SaveAs("quarterly_sales.xlsx");
// Alternative: Save as legacy XLS format for older Excel versions
workbook.SaveAs("quarterly_sales.xls");
Console.WriteLine("CSV successfully converted to Excel format");

SaveAs メソッドは、ファイル拡張子に基づいて出力形式を自動的に決定します。 XLSX は Excel 2007 以降と互換性のある最新の Office Open XML ファイルを作成し、XLS は古いアプリケーション用の従来のバイナリ交換ファイル形式のドキュメントを生成します。

CSV データ内の特定のセルの値にアクセスするにはどうすればよいですか?

IronXLはすべてのレコードを反復処理するだけでなく、使い慣れたExcelスタイルのアドレス指定を使って直接セルにアクセスすることもできます。 これにより、さまざまなデータ型にわたって、的を絞ったデータ抽出と型安全な値の取得が可能になります。

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("inventory.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Access specific cells using Excel-style addresses by index
string productName = sheet["A2"].StringValue;
int quantity = sheet["B2"].IntValue;
decimal price = sheet["C2"].DecimalValue;
Console.WriteLine($"Product: {productName}");
Console.WriteLine($"Quantity: {quantity}");
Console.WriteLine($"Price: ${price:F2}");
// Access a range of cells -- return records from column A
var productRange = sheet["A2:A10"];
Console.WriteLine("\nAll products:");
foreach (var cell in productRange)
{
    Console.WriteLine($"  - {cell.StringValue}");
}

using IronXL;

WorkBook workbook = WorkBook.LoadCSV("inventory.csv", ExcelFileFormat.XLSX, ",");
WorkSheet sheet = workbook.DefaultWorkSheet;
// Access specific cells using Excel-style addresses by index
string productName = sheet["A2"].StringValue;
int quantity = sheet["B2"].IntValue;
decimal price = sheet["C2"].DecimalValue;
Console.WriteLine($"Product: {productName}");
Console.WriteLine($"Quantity: {quantity}");
Console.WriteLine($"Price: ${price:F2}");
// Access a range of cells -- return records from column A
var productRange = sheet["A2:A10"];
Console.WriteLine("\nAll products:");
foreach (var cell in productRange)
{
    Console.WriteLine($"  - {cell.StringValue}");
}

セルのアドレス指定はExcelの慣例に従い、アルファベットはCSVの列(A、B、C)を表し、数字は行のインデックス位置(1、2、3)を表します。 Cellクラスは、BoolValue、および DateTimeValue などの型固有のアクセサーを提供します。 これらのアクセサは解析と変換を自動的に処理し、すべてを文字列値として保存する場合と比較して、手動による型キャストを排除します。

A2:A10 のような表記法を使用した範囲選択は、反復、集計関数、および一括操作をサポートするRangeオブジェクトを返します。 これは、大きなCSVファイルから特定の列や長方形のデータ領域を抽出する際に役立ちます。 例えば、特定の列から値のリストを作成したり、フィルタリングされたデータを別のファイルに書き込んだりすることができます。その他のパタ​​ーンについては、 IronXLレンジガイドをご覧ください。

CSV ファイルの読み取り時にエラーをどのように処理しますか?

実稼働アプリケーションでは、ファイル操作に関する防御コードが必要です。 CSV の読み取りが失敗する理由はいくつかあります。ファイルが存在しない、アクセスが拒否された、データが不正な形式である、または非常に大きなファイルに対してメモリが不足しているなどです。 IronXL呼び出しを try/catch ブロックでラップし、ロード前にパスを検証すると、環境間で信頼性の高い動作が実現します。

using IronXL;
using System.IO;

string filePath = "customers.csv";
if (!File.Exists(filePath))
{
    Console.WriteLine($"File not found: {filePath}");
    return;
}
try
{
    WorkBook workbook = WorkBook.LoadCSV(filePath, ExcelFileFormat.XLSX, ",");
    WorkSheet sheet = workbook.DefaultWorkSheet;
    DataTable dataTable = sheet.ToDataTable(true);
    Console.WriteLine($"Loaded {dataTable.Rows.Count} records successfully.");
}
catch (IronXl.Exceptions.IronXLException ex)
{
    Console.WriteLine($"IronXL parsing error: {ex.Message}");
}
catch (IOException ex)
{
    Console.WriteLine($"File access error: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Unexpected error: {ex.Message}");
}

using IronXL;
using System.IO;

string filePath = "customers.csv";
if (!File.Exists(filePath))
{
    Console.WriteLine($"File not found: {filePath}");
    return;
}
try
{
    WorkBook workbook = WorkBook.LoadCSV(filePath, ExcelFileFormat.XLSX, ",");
    WorkSheet sheet = workbook.DefaultWorkSheet;
    DataTable dataTable = sheet.ToDataTable(true);
    Console.WriteLine($"Loaded {dataTable.Rows.Count} records successfully.");
}
catch (IronXl.Exceptions.IronXLException ex)
{
    Console.WriteLine($"IronXL parsing error: {ex.Message}");
}
catch (IOException ex)
{
    Console.WriteLine($"File access error: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"Unexpected error: {ex.Message}");
}

メモリの問題を起こさずに大きな CSV ファイルを読み取るにはどうすればよいでしょうか?

数十万行のファイルの場合、データセット全体を一度にメモリにロードするのは非現実的です。 IronXL はファイル全体を WorkBook オブジェクトに読み込み、すべてのデータをメモリ内に保持します。 大規模な ETL (抽出、変換、ロード) シナリオの場合、実用的な戦略は、ロードする前にソース ファイルを分割するか、StreamReader から行をストリーミングしてチャンクを別のブックに書き込むことによって、CSV をバッチで処理することです。

Excel ファイルの読み取りに関するIronXLドキュメントでは、大規模なワークロードのパフォーマンスに関する考慮事項について説明しています。 特に CSV の場合、CSV 形式の行単位の構造は、データセットが単一のメモリ内ロードには大きすぎる場合に、手動でバッチ処理する単純な File.ReadAllLines によって予測可能なメモリ フットプリントが提供されることを意味します。

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

.NETでCSVファイルを読むには、適切なアプローチを使用すれば、最小限の労力で済みます。 IronXL の LoadCSV メソッドは、解析の複雑さを自動的に処理し、さまざまな区切り文字をサポートし、構造化データへの即時アクセスを提供し、単一のメソッド呼び出しで Excel または DataTable に変換します。 ASP.NET Coreアプリケーション、 .NET Core Web API、コンソール プロジェクトのいずれを構築する場合でも、このライブラリを使用すると、最初から最後まで CSV 処理が簡素化されます。

ここで学んだことをさらに発展させるために、 IronXL のその他の機能を調べてください。

• IronXL製品ページ- 完全な機能リストとライセンス
• C# で Excel ファイルを読み取る方法- CSV スキルを XLSX/XLS に拡張する
• C# で Excel ファイルを作成する方法- プログラムでスプレッドシートを作成してエクスポートする
• DataTable および DataSet のエクスポート- ADO .NETワークフローに接続
• IronXLライセンス- 展開のためのライセンス オプション

無料トライアルを開始して、 IronXL が.NETプロジェクトでの CSV ファイルの読み取りをいかに簡素化するかを体験してください。 実稼働展開の場合、ライセンス オプションには永久使用権と 1 年間のサポートが含まれます。