IronXLで.NET Core CSV リーダーを使用する方法: 実例

.NET Core CSV リーダーとしてIronXL を選択する理由

.NET Core CSV リーダーを選択する場合、 IronXL は従来の CSV 解析ライブラリに比べていくつかの魅力的な利点を提供します。 IronXL は、.NET Frameworkプロジェクトとの下位互換性を維持しながら、 .NET Core の最新アーキテクチャと統合されます。 このソリューションは、CSV ファイル操作を行う際に開発者が直面する次のような一般的な問題点を解消します。

• 国際文字セットの自動エンコーディング検出
• 手動設定なしのインテリジェント デリミタ認識
• キロバイトからギガバイトに及ぶメモリ効率の高い処理
• 組み込みデータ型の推論と変換
• プラットフォーム間のキャリッジリターンとラインフィードの処理
• CSV データを扱う際にも Excel の数式サポート
• Windows、Linux、macOSでのクロスプラットフォームの信頼性

広範な構成と手動の解析ロジックを必要とする基本的な CSV リーダーとは異なり、 IronXL は、区切り文字、複数行のセル値、特殊文字を含む引用符で囲まれたフィールドなどのエッジ ケースを自動的に処理します。 ライブラリのアーキテクチャは、遅延読み込みとストリーミング機能を通じて最適なパフォーマンスを保証するため、小さな構成ファイルと大規模なデータ処理タスクの両方に適しています。 IronXL は、必要に応じてヘッダー行をスキップし、複雑なデータ構造を効率的に分割できます。 詳細については、 IronXL機能の概要をご覧ください。

レガシーシステムから移行する開発者向けに、IronXL は、学習曲線を減少させる一方で、応答性のあるアプリケーション向けの最新の非同期/await パターンを提供する馴染みのあるAPIを提供しています。 そのため、データ処理インフラストラクチャを最新化するチームにとって理想的な選択肢となります。 API リファレンスと構成オプションについては、 IronXL の完全なドキュメントを参照してください。

CSV ファイル読み取り用にIronXLをインストールするにはどうすればよいでしょうか?

コンソール アプリケーション、 ASP.NET Core Web アプリ、Windows フォーム アプリケーションのいずれを構築する場合でも、 .NET CoreプロジェクトにIronXLをインストールするのにかかる時間はわずか数秒です。 .NET Core でCSVファイルを効率的に解析し、CSVデータの読み取りを開始するには、Visual Studio のパッケージ マネージャー コンソールを開いて次を実行します:

Install-Package IronXl.Excel

Install-Package IronXl.Excel

または.NET CLIを使用します：

dotnet add package IronXl.Excel

dotnet add package IronXl.Excel

NuGet パッケージ マネージャー UI を使用して "IronXl.Excel" を検索し、インストールをクリックします。 このライブラリは、.NET Coreへの移行中に既存 for .NET Frameworkプロジェクトと統合されます。 IronXL NuGetページから直接参照することもできます。

インストール後、名前空間をコードに追加します:

using IronXL;

using IronXL;

このセットアップにより、Microsoft Office や Interop の依存関係を必要とせずに強力な CSV 読み取り機能にアクセスできるため、クラウド展開や Docker コンテナーに最適です。 詳細なインストール手順と構成設定については、 IronXLインストール ガイドのドキュメントを参照してください。

IronXL の LoadCSV メソッドを使用して CSV ファイルを読み取るにはどうすればよいでしょうか?

IronXL は、以下の例に示すように、CSV ヘッダー、CSV 列、CSV 行を効率的に処理する LoadCSV メソッドを使用して、CSV ファイルの処理を簡単にします。

// Load CSV file into a WorkBook object for .NET Core CSV reading
var workbook = WorkBook.LoadCSV("Budget.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Access the default worksheet containing parsed CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values with type-safe methods
string cellValue = worksheet["A1"].StringValue;
// Iterate through a range for bulk CSV data processing
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"Cell {cell.AddressString}: {cell.Text}");
}

// Load CSV file into a WorkBook object for .NET Core CSV reading
var workbook = WorkBook.LoadCSV("Budget.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Access the default worksheet containing parsed CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values with type-safe methods
string cellValue = worksheet["A1"].StringValue;
// Iterate through a range for bulk CSV data processing
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"Cell {cell.AddressString}: {cell.Text}");
}

LoadCSV メソッドは、最適化されたメモリ ストリーム処理を使用して、メモリ内の CSV データ構造を表す WorkBook オブジェクトを作成します。 fileFormat パラメータは処理の内部形式を指定し、listDelimiter は CSV ファイル内で使用される CSV 区切り文字を定義します (タブ区切りファイルとパイプ区切り形式がサポートされています)。

public record Customer(string Name, int Age, string City)
{
    public bool IsValid() => !string.IsNullOrEmpty(Name) && Age > 0;
}

// Parse CSV rows into typed objects
var customers = new List<Customer>();
for (int row = 2; row <= worksheet.RowCount; row++)
{
    var customer = new Customer(
        Name: worksheet[$"A{row}"].StringValue,
        Age:  worksheet[$"B{row}"].IntValue,
        City: worksheet[$"C{row}"].StringValue
    );
    if (customer.IsValid())
        customers.Add(customer);
}
// Output the records
foreach (var record in customers)
{
    Console.WriteLine($"Customer: {record.Name}, Age: {record.Age}, City: {record.City}");
}

public record Customer(string Name, int Age, string City)
{
    public bool IsValid() => !string.IsNullOrEmpty(Name) && Age > 0;
}

// Parse CSV rows into typed objects
var customers = new List<Customer>();
for (int row = 2; row <= worksheet.RowCount; row++)
{
    var customer = new Customer(
        Name: worksheet[$"A{row}"].StringValue,
        Age:  worksheet[$"B{row}"].IntValue,
        City: worksheet[$"C{row}"].StringValue
    );
    if (customer.IsValid())
        customers.Add(customer);
}
// Output the records
foreach (var record in customers)
{
    Console.WriteLine($"Customer: {record.Name}, Age: {record.Age}, City: {record.City}");
}

さまざまな区切り文字を処理して DataTable に変換するにはどうすればよいでしょうか?

実際の CSV ファイル形式では、コンマ以外にもさまざまな区切り文字が使用されることが多く、柔軟な処理が必要になります。 IronXL は、自動区切り文字検出によってこれをエレガントに管理します。

// Load CSV with semicolon delimiter
WorkBook workbook = WorkBook.LoadCSV("products.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Convert to DataTable for database operations
DataTable dataTable = worksheet.ToDataTable(true);
// Process the DataTable
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Product: {row["ProductName"]}, Price: {row["Price"]}");
}

// Load CSV with semicolon delimiter
WorkBook workbook = WorkBook.LoadCSV("products.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ";");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Convert to DataTable for database operations
DataTable dataTable = worksheet.ToDataTable(true);
// Process the DataTable
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Product: {row["ProductName"]}, Price: {row["Price"]}");
}

ToDataTable メソッドは、ワークシート データを.NET DataTable に変換します。ブール パラメーターは、最初の行を列ヘッダーとして使用するかどうかを示します。 この変換は、データベース操作、 ASP.NET Coreアプリケーションでのデータ バインディング、または SQL Server 統合に既存の DataTable 処理ロジックを適用する必要がある場合に特に役立ちます。 結果の DataTable はデータ型とスキーマ情報を維持し、効率的な一括挿入操作のために SqlBulkCopy で直接使用できます。

CSV を DataTable にインポートし、 データベースを統合する方法の詳細については、詳細なガイドをご覧ください。

// Load a DataTable from your data source
DataTable exportTable = GetProcessedData(); // your data source method

// Create a new workbook and populate it from the DataTable
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.DefaultWorkSheet;

// Write headers from DataTable columns
for (int col = 0; col < exportTable.Columns.Count; col++)
{
    outputSheet[0, col].Value = exportTable.Columns[col].ColumnName;
}

// Write rows
for (int row = 0; row < exportTable.Rows.Count; row++)
{
    for (int col = 0; col < exportTable.Columns.Count; col++)
    {
        outputSheet[row + 1, col].Value = exportTable.Rows[row][col]?.ToString();
    }
}

// Save as CSV
outputWorkbook.SaveAsCsv("output.csv", delimiter: ",");
Console.WriteLine("Export complete.");

// Load a DataTable from your data source
DataTable exportTable = GetProcessedData(); // your data source method

// Create a new workbook and populate it from the DataTable
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.DefaultWorkSheet;

// Write headers from DataTable columns
for (int col = 0; col < exportTable.Columns.Count; col++)
{
    outputSheet[0, col].Value = exportTable.Columns[col].ColumnName;
}

// Write rows
for (int row = 0; row < exportTable.Rows.Count; row++)
{
    for (int col = 0; col < exportTable.Columns.Count; col++)
    {
        outputSheet[row + 1, col].Value = exportTable.Rows[row][col]?.ToString();
    }
}

// Save as CSV
outputWorkbook.SaveAsCsv("output.csv", delimiter: ",");
Console.WriteLine("Export complete.");

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

IronXL の優れた機能の 1 つは、データ移行プロジェクトに不可欠な、CSV から Excel への変換と Excel から CSV への変換です。 次の例は、この機能を示しています:

// Load CSV and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Save as Excel file
csvWorkbook.SaveAs("report.xlsx");
// Or load Excel and export to CSV
WorkBook excelWorkbook = WorkBook.Load("data.xlsx");
excelWorkbook.SaveAsCsv("exported_data.csv", delimiter: ",");

// Load CSV and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
// Save as Excel file
csvWorkbook.SaveAs("report.xlsx");
// Or load Excel and export to CSV
WorkBook excelWorkbook = WorkBook.Load("data.xlsx");
excelWorkbook.SaveAsCsv("exported_data.csv", delimiter: ",");

この双方向の変換はデータの整合性を保持し、さまざまなファイル変換シナリオに対するフォーマットの柔軟性を提供します。 SaveAs メソッドは、ファイル拡張子から目的の形式を自動的に検出し、ワークシート管理を備えた XLSX、XLS、およびその他の Excel 形式をサポートします。 SaveAsCsv を使用して CSV に保存する場合、要件に合わせてカスタム区切り文字とテキスト エンコードを指定できます。

この機能は、データ交換用に特定のファイル形式を要求するシステムと統合する際に非常に貴重です。 他のライブラリから移行する開発者や手動パース代替案の評価に関心のある方は、Stack Overflow で議論されている人気の代替案 および .NET コミュニティでのパフォーマンスの考慮事項 を確認してください。 その他のファイル形式の変換パターンについては、 Excel スプレッドシートの変換ガイドをご覧ください。

WorkBook workbook = WorkBook.LoadCSV("large-dataset.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;

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

for (int start = 1; start <= totalRows; start += batchSize)
{
    int end = Math.Min(start + batchSize - 1, totalRows);
    for (int row = start; row <= end; row++)
    {
        string id   = worksheet[$"A{row}"].StringValue;
        string name = worksheet[$"B{row}"].StringValue;
        // Process each record here
        Console.WriteLine($"Row {row}: {id} - {name}");
    }
    Console.WriteLine($"Processed batch {start}-{end}");
}

WorkBook workbook = WorkBook.LoadCSV("large-dataset.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;

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

for (int start = 1; start <= totalRows; start += batchSize)
{
    int end = Math.Min(start + batchSize - 1, totalRows);
    for (int row = start; row <= end; row++)
    {
        string id   = worksheet[$"A{row}"].StringValue;
        string name = worksheet[$"B{row}"].StringValue;
        // Process each record here
        Console.WriteLine($"Row {row}: {id} - {name}");
    }
    Console.WriteLine($"Processed batch {start}-{end}");
}

エンタープライズ CSV 処理のために IronXL が提供する高度な機能とは何ですか？

IronXL は、ユニット テスト サポートやデバッグ ツールなど、基本的な CSV パーサーとは一線を画すエンタープライズ グレードの機能を提供します。 このライブラリは、Windows、Linux、macOS、Docker コンテナーで実行できるクロスプラットフォームの互換性を備えており、最新 for .NET Core展開とマイクロサービス アーキテクチャに不可欠です。 Microsoft のドキュメント によれば、クロスプラットフォームサポートはクラウドネイティブ アプリケーションおよび Azure デプロイメントにおいて重要です。

技術的な機能を超えて、IronXL にはすべてのライセンスにプロフェッショナルサポートと定期的な更新が含まれており、最新の .NET バージョンおよびセキュリティ修正との互換性を保証します。 この商業的サポートにより、オープンソースのライブラリが実稼働環境で不足する可能性のある重要なアプリケーションの信頼性が保証されます。 このライブラリは、最適化されたメモリ管理を通じて大規模なデータセットを効率的に処理し、次のような高度なシナリオをサポートします。

スケーラビリティと負荷分散を必要とする本番環境の展開では、IronXL のライセンス モデルが、単一プロジェクト、チーム、企業全体での使用のオプションによって柔軟性を提供します。これらすべてに、ソース コード アクセスとロイヤリティフリーの再配布権が含まれます。 ライセンスを購入すると、透かしなしで全機能を利用できるようになります。

// Apply license key at application startup
IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Then proceed with CSV reading as normal
WorkBook workbook = WorkBook.LoadCSV("data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;
Console.WriteLine($"Loaded {worksheet.RowCount} rows from CSV.");

// Apply license key at application startup
IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Then proceed with CSV reading as normal
WorkBook workbook = WorkBook.LoadCSV("data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    listDelimiter: ",");
WorkSheet worksheet = workbook.DefaultWorkSheet;
Console.WriteLine($"Loaded {worksheet.RowCount} rows from CSV.");

無料トライアルを始めるにはどうすればいいですか?

IronXLは、.NET CoreアプリケーションでのCSVの読み書きを簡素化すると同時に、データ分析、レポート作成、自動化タスクなどの複雑なシナリオを処理する柔軟性を提供します。 直感的な API と Excel 形式のサポートおよびエンタープライズ機能を組み合わせることで、スレッド セーフと同時アクセス サポートを備えた実証済みの CSV 処理機能を必要とする開発者にとって信頼できる選択肢となります。 ライブラリは、形式間の変換、さまざまな区切り文字の処理、データ クレンジングの実行、既存 for .NETデータ構造との統合を行う機能を備えているため、コードの保守性を維持しながら開発時間を大幅に短縮できます。

CSV ファイルの処理を開始する準備はできましたか? 今すぐIronXLの無料トライアルをダウンロードして、ライブラリがプロフェッショナル グレードの CSV 解析機能を使用してデータ処理ワークフローをどのように変革するかを体験してください。 運用環境での使用には、専門的なサポート、ドキュメント、 .NETプロジェクトの継続的な更新が含まれるライセンス オプションを検討してください。

さらに読むための追加リソース:

• C#コンソールアプリケーションでExcelファイルを読み取る方法
• C#でCSVファイルを作成するチュートリアル
• C# で DataTable を Excel にエクスポートする
• IronXLオブジェクト参照 API
• Linux、macOS、Docker、AWS を使い始める