IronXLとCsvHelperの比較

IronXLの機能セット

• データをロード、読み取り、編集 — XLS/XLSX/CSV/TSV から
• 保存とエクスポート — XLS/XLSX/CSV/TSV/JSON へ
• 範囲 — 使いやすい WorkSheet["A1:B10"] 構文。 直感的に範囲を結合・作成します。
• ソート — 範囲、列、行のソート。
• スタイリング — セルの視覚スタイル、フォント、サイズ、背景パターン、境界、配置、番号フォーマット。

CsvHelperの特徴

• 高速: クラスをフライでコンパイルして極めて高速なパフォーマンスを実現
• 柔軟: 書き込みは保守的、読み込みは自由
• 簡単: GetRecords() と WriteRecords(records) のように簡単
• 高度に設定可能
• Linux対応モード
• メモリ使用量が少ない

2.1. NuGetパッケージを使用したVisual Studio経由で

Visual Studioは、NuGetパッケージをプロジェクトにインストールするNuGetパッケージマネージャーを提供しています。 これにアクセスするには、プロジェクトメニューを通じて、またはソリューションエクスプローラでプロジェクトを右クリックして行います。

NuGet パッケージの管理を選択

• 今度は、ブラウズ タブから、IronXL.Excel を検索 -> インストールします

IronXLを検索

• 完了しました。

2.2. NuGetパッケージを直接ダウンロード

これはNuGetサイトに直接アクセスしてパッケージをダウンロードすることによって行うことが可能です。 手順は次の通りです:

• https://www.nuget.org/packages/IronXL.Excel に移動します
• "パッケージをダウンロード"を選択
• ダウンロードしたパッケージをダブルクリックします
• パッケージがインストールされます
• Visual Studio プロジェクトをリロードして、使用を開始します

2.3. DLLで手動インストール

もう一つのIronXL C#ライブラリをダウンロードしてインストールする方法は、Developer Command Promptを使用してIronXL NuGetパッケージをインストールする以下の手順を実行することです。

• 開発者コマンドプロンプト を開く — 通常は Visual Studio フォルダ内にあります。
• 次のコマンドを入力します: PM> Install-Package IronXL.Excel
• Enterキーを押します
• これにより、パッケージのダウンロードとインストールが行われます
• Visual Studio プロジェクトをリロードして、使用を開始します

2.4. 必要なusingディレクティブを追加

1. ソリューションエクスプローラーで Program.cs ファイルを右クリックして、[コードの表示] をクリックします。
2. コードファイルの冒頭に以下のusingディレクティブを追加します。

using IronXL;

using IronXL;

これで完了です！ IronXLはダウンロードされ、インストールされ、使用準備が整いました。 ただし、その前に CsvHelper をインストールするべきです。

3.1. NuGet パッケージ マネージャー コンソールを使う場合

CsvHelper C# ライブラリをダウンロードしてインストールするには、開発者コマンドプロンプトを介して NuGet パッケージ をインストールするための次の手順を使用します。

• 開発者コマンドプロンプト を開く — 通常は Visual Studio フォルダ内にあります。
• 次のコマンドを入力します: PM> Install-Package CsvHelper -Version 27.2.1
• Enterキーを押します
• これにより、パッケージのダウンロードとインストールが行われます
• Visual Studio プロジェクトをリロードして、使用を開始します

3.2. 直接ダウンロード

NuGetウェブサイトからダウンロードしてください: https://www.nuget.org/packages/CsvHelper。

4.1. CSVファイルをExcel形式に変換

このプロセスは非常に簡単で簡潔です。 通常、1行のコードで完了します。

CSVからExcel形式へ:

// Load the CSV file and convert it to an Excel format
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Access the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

// Load the CSV file and convert it to an Excel format
WorkBook workbook = WorkBook.LoadCSV("test.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");
// Access the default worksheet
WorkSheet ws = workbook.DefaultWorkSheet;

// Save the workbook as an Excel file
workbook.SaveAs("CsvToExcelConversion.xlsx");

4.2. IronXL を使用して変換された CSV ファイルを読み取りおよび操作

IronXLのWorkBookクラスはExcelシートを表します。 C#を使用してExcelファイルを開くためには、WorkBook.Loadを使用し、Excelファイル（.xlsx）のパスを指定します。 以下の1行コードは、読み取りのためにファイルを開くために使用されます:

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets/sample.xlsx");

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets/sample.xlsx");

各 WorkBook は複数の WorkSheet オブジェクトを含むことができます。 これらはExcelドキュメントのワークシートを表しています。 ワークブックにワークシートがある場合、次のようにして名前で取得します:

// Open the sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

// Open the sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

セル値を読み取るためのコード:

// Read from ranges of cells elegantly
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read from ranges of cells elegantly
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

ワークブックとワークシートを読み込んだ後、次のコード例を使用して、数式の変更を行ったり、特定のセルに適用することができます。 コードは次の通りです：

// Set formulas in specific cells
worksheet["A1"].Formula = "SUM(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "MAX(C3:C7)";

// Force recalculate all formula values in all sheets
workbook.EvaluateAll();

// Set formulas in specific cells
worksheet["A1"].Formula = "SUM(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "MAX(C3:C7)";

// Force recalculate all formula values in all sheets
workbook.EvaluateAll();

4.3. Excel文書をCSVファイルに保存する

CSVファイルの書き込みは、IronXLを使用することで簡単なプロセスです。 次のコードは、単にExcelファイルをCSV形式で SaveAsCsv メソッドを利用して保存します。

// Load the Excel Workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");

// Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// This will save as "SaveAsCSV.Sheet1.csv"

// Load the Excel Workbook
WorkBook wb = WorkBook.Load("Normal_Excel_File.xlsx");

// Save the workbook as a CSV file
wb.SaveAsCsv("SaveAsCSV.csv", ",");
// This will save as "SaveAsCSV.Sheet1.csv"

5.1. CsvHelperでCSVファイルを読み込む

こちらがサンプルのCSVファイルです。それには3つのテキストカラムと1つのナンバーカラムがあります。

FirstName,LastName,Age,IsActive
Ali,Talal,30,Yes
Affan,Ahmad,31,No
Saad,Bhatti,31,Yes

各行を Person タイプのオブジェクトにマッピングします。

// Define the Person class to map CSV records
public class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int? Age { get; set; }
    public string IsActive { get; set; }
}

// Define the Person class to map CSV records
public class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int? Age { get; set; }
    public string IsActive { get; set; }
}

私たちのCSVファイルを読むためのコードは以下です。

// Define the path to the CSV file
var fileName = @"<path to our CSV file>";

// Configure CsvHelper
var configuration = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    Encoding = Encoding.UTF8,
    Delimiter = ","
};

// Read CSV file
using (var fs = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read))
{
    using (var textReader = new StreamReader(fs, Encoding.UTF8))
    using (var csv = new CsvReader(textReader, configuration))
    {
        var data = csv.GetRecords<Person>();

        // Iterate over each person record
        foreach (var person in data)
        {
            // Process each Person object
        }
    }
}

// Define the path to the CSV file
var fileName = @"<path to our CSV file>";

// Configure CsvHelper
var configuration = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    Encoding = Encoding.UTF8,
    Delimiter = ","
};

// Read CSV file
using (var fs = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.Read))
{
    using (var textReader = new StreamReader(fs, Encoding.UTF8))
    using (var csv = new CsvReader(textReader, configuration))
    {
        var data = csv.GetRecords<Person>();

        // Iterate over each person record
        foreach (var person in data)
        {
            // Process each Person object
        }
    }
}

data のタイプは IEnumerable<Person> です。 CsvHelperは、それぞれのカラムを同じ名前のプロパティに自動的にマッピングします。 例えば、FirstName カラムの値は Person.FirstName にマッピングされます。 その後、dataをイテレートして、各行の値にアクセスすることができます。

5.2. CSVファイル内のデータをある型から別の型へ変換する

CSVファイルは主にテキストデータを含んでいます。 例えば、年齢カラムは整数値であり、CSVファイルはテキストのみを含んでいます。 CsvHelperは、文字列から標準の.NET型（Boolean, Int32, Int64, Enum）にデータを変換することができます。 私たちの場合、IsActiveというブールデータ型があり、True/False のみを持つことができ、標準ではない値を含んでいます。 カスタムコンバーターを作成することで、これを変換することができます。 コードのスタイリングは次の通りです。

// Custom Boolean Converter for CsvHelper
public class CustomBooleanConverter : DefaultTypeConverter
{
    public override object ConvertFromString(string text, IReaderRow row, MemberMapData memberMapData)
    {
        // Convert "Yes" to true and anything else to false
        return text.Equals("Yes", StringComparison.OrdinalIgnoreCase);
    }
}

// Custom Boolean Converter for CsvHelper
public class CustomBooleanConverter : DefaultTypeConverter
{
    public override object ConvertFromString(string text, IReaderRow row, MemberMapData memberMapData)
    {
        // Convert "Yes" to true and anything else to false
        return text.Equals("Yes", StringComparison.OrdinalIgnoreCase);
    }
}

たとえboolが標準の.NET型であっても、デフォルトのコンバーターはTrue/Falseしか処理できませんが、私たちのCSVファイルにはYes/Noがあります。 ここでは、DefaultTypeConverterをサブクラス化し、ConvertFromStringメソッドをオーバーライドする必要があります。

概要

IronXLはExcelファイルを操作するために必要なすべてを提供する完全なライブラリです。使用が簡単で、さまざまな形式をXLSXに、またXLSXをCSVなどの他の形式に変換する機能を提供します。この相互変換は、さまざまなファイル形式を簡単に操作する柔軟性をユーザーに提供します。

一方、CsvHelperは、CSVファイル形式と特に連携するために設計されており、CSVファイルのみを処理できます。 すべてのサンプルコードはCsvHelperのドキュメントファイルにあります。 ドキュメントでは、プロジェクトでCsvHelperを使用する方法についてのガイドラインが示されています。

結論

IronXLは複数の形式で作業するユーザーをサポートしているため、CsvHelperに対して明らかな利点があります。 さらに、選択に応じて数式やスタイルを適用することができますが、CsvHelperは限られたオプションでCSVファイルの読み書きしかできません。 また、新しいレコードを既存のCSVファイルに追加することはできず、以前のエントリを上書きしてしまいます。