ExcelDataReaderがExcelファイルを書き込む：ExcelDataReaderがExcelファイルを書けない理由とIronXLによる解決方法

ExcelDataReader は Excel ブックのデータを書き込むことができますか?

いいえ。ExcelDataReaderは設計上、読み取り専用ライブラリであり、その制限は意図的なものです。 ExcelDataReaderの公式GitHubリポジトリでは、このプロジェクトは"Microsoft Excelファイルを読み取るためのライブラリ"であると明示的に説明されており、公開されているインターフェースには書き込みAPI、保存メソッド、セル値設定機能などは一切存在しない。 ExcelDataReader NuGetパッケージのページを参照すれば、このことをご自身で確認できます。パッケージの説明には、読み取り専用のスコープであることが明記されています。

ExcelDataReaderは、XLS、XLSX、CSV形式のファイルの読み込みをサポートしており、その処理を効率的に行います。 このライブラリは、 .NETのIDataReaderに似た、ストリーミングによる前方のみのリーダー パターンを提供します。 そのアーキテクチャは大規模なデータセットを迅速に抽出するのに適しているが、Excelでの書き込みに必要なランダムアクセスかつ可変的なモデルとは根本的に相容れない。

以下のコードは、ExcelDataReaderで発生する上限を示しています。

using ExcelDataReader;
using System.Text;

// Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

using var stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read);
using var reader = ExcelReaderFactory.CreateReader(stream);

while (reader.Read())
{
    string cellValue = reader.GetString(0); // Read a cell value
    Console.WriteLine(cellValue);
    // There is no Write(), Save(), or SetCellValue() method here
}

using ExcelDataReader;
using System.Text;

// Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

using var stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read);
using var reader = ExcelReaderFactory.CreateReader(stream);

while (reader.Read())
{
    string cellValue = reader.GetString(0); // Read a cell value
    Console.WriteLine(cellValue);
    // There is no Write(), Save(), or SetCellValue() method here
}

Imports ExcelDataReader
Imports System.Text
Imports System.IO

' Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)

Using stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read)
    Using reader = ExcelReaderFactory.CreateReader(stream)
        While reader.Read()
            Dim cellValue As String = reader.GetString(0) ' Read a cell value
            Console.WriteLine(cellValue)
            ' There is no Write(), Save(), or SetCellValue() method here
        End While
    End Using
End Using

Read() を呼び出した後、Write() または Save() に相当するものは存在しません。 アプリケーションでレポートを作成したり、スプレッドシートのセルを更新したり、データをXLSX形式にエクスポートしたり、数式を適用したり、テンプレートを処理したりする必要がある場合、ExcelDataReaderでは必要なツールが何も提供されません。

これはバグではありません。 これは意図的な範囲決定です。 ExcelDataReaderは一つのことをうまくこなすが、それ以上は何もしない。 Excelにデータを書き戻すワークフローには、全く別のライブラリが必要になります。

IronXL はライティングの問題をどのように解決しますか?

IronXLは、Microsoft Officeをインストールすることなく、Excelファイルの読み取り、作成、変更、保存を行うための統一されたAPIを提供します。 このライブラリは、Excelワークブックを完全に変更可能な、メモリ上のオブジェクトグラフとして扱います。 ワークブックを読み込むか作成し、参照によって任意のセルに移動し、値や数式を設定し、スタイルを適用してから、SaveAs() を呼び出します。これは、人間が Excel 自体で作業する方法を模倣したワークフローです。

IronXLは、入力と出力の両方でXLSX、XLS、CSV、TSV、およびJSON形式をサポートしています。 .NET 10、 .NET Standard、および.NET Frameworkで動作するため、コンソールアプリケーション、 ASP.NET Core Web API、デスクトップツール、バックグラウンド処理サービスなど、あらゆる用途に適しています。

Install-Package IronXL

Install-Package IronXL

dotnet add package IronXL

dotnet add package IronXL

using IronXL;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Report");

// Write header row
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["C1"].Value = "Unit Price";

// Write a data row
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 150;
sheet["C2"].Value = 9.99;

workBook.SaveAs("report.xlsx");
Console.WriteLine("Workbook saved.");

using IronXL;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Report");

// Write header row
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["C1"].Value = "Unit Price";

// Write a data row
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 150;
sheet["C2"].Value = 9.99;

workBook.SaveAs("report.xlsx");
Console.WriteLine("Workbook saved.");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Report")

' Write header row
sheet("A1").Value = "Product"
sheet("B1").Value = "Quantity"
sheet("C1").Value = "Unit Price"

' Write a data row
sheet("A2").Value = "Widget"
sheet("B2").Value = 150
sheet("C2").Value = 9.99

workBook.SaveAs("report.xlsx")
Console.WriteLine("Workbook saved.")

IronXLのワークフロー内で、データの読み書きをどのように行うのですか？

よくある要件としては、既存のExcelファイルを読み込み、そのデータを変換し、結果を書き戻すというものがあります。 ExcelDataReaderは最初のステップしか処理しないため、2つ目のライブラリを導入する必要があります。これは不要な複雑さを招き、依存関係の管理オーバーヘッドやバージョン競合の可能性を高めます。

IronXLはパイプライン全体をカバーします。以下の例では、ソースファイルを読み込み、A列から値を読み取り、変換処理を行い、変更後のワークブックを新しいファイルとして保存します。

using IronXL;

WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read existing data
string originalValue = sheet["A1"].StringValue;
Console.WriteLine($"Original: {originalValue}");

// Modify existing data
sheet["A1"].Value = originalValue.ToUpper();

// Add new data alongside existing content
sheet["B1"].Value = DateTime.Now.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

workBook.SaveAs("modified.xlsx");
Console.WriteLine("Modified workbook saved.");

using IronXL;

WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read existing data
string originalValue = sheet["A1"].StringValue;
Console.WriteLine($"Original: {originalValue}");

// Modify existing data
sheet["A1"].Value = originalValue.ToUpper();

// Add new data alongside existing content
sheet["B1"].Value = DateTime.Now.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

workBook.SaveAs("modified.xlsx");
Console.WriteLine("Modified workbook saved.");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Load("source.xlsx")
Dim sheet As WorkSheet = workBook.DefaultWorkSheet

' Read existing data
Dim originalValue As String = sheet("A1").StringValue
Console.WriteLine($"Original: {originalValue}")

' Modify existing data
sheet("A1").Value = originalValue.ToUpper()

' Add new data alongside existing content
sheet("B1").Value = DateTime.Now.ToString("yyyy-MM-dd")
sheet("C1").Formula = "=LEN(A1)"

workBook.SaveAs("modified.xlsx")
Console.WriteLine("Modified workbook saved.")

WorkBook.Load() 呼び出しは、ファイルを可変オブジェクトとしてメモリに読み込みます。 その後、Excelスタイルの参照を使用してセルを移動し、値を更新し、数式を設定し、保存します。これらすべてが単一のライブラリと単一のAPIパターン内で実行されます。

IronXLはどのような高度な執筆機能をサポートしていますか？

IronXLは、単純なセル割り当てにとどまらず、ビジネスアプリケーションで一般的に必要とされるExcelのあらゆる機能を提供します。

using IronXL;
using IronXl.Styles;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Analytics");

// Write labels
sheet["A1"].Value = "Revenue";
sheet["B1"].Value = "Cost";
sheet["C1"].Value = "Margin";

// Write data
sheet["A2"].Value = 50000;
sheet["B2"].Value = 32000;

// Write a calculated formula
sheet["C2"].Formula = "=A2-B2";

// Apply bold formatting to the header row
sheet["A1:C1"].Style.Font.Bold = true;

// Highlight the margin cell
sheet["C2"].Style.BackgroundColor = "#D4EDDA";
sheet["C2"].Style.Font.Bold = true;

workBook.SaveAs("analytics.xlsx");

using IronXL;
using IronXl.Styles;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Analytics");

// Write labels
sheet["A1"].Value = "Revenue";
sheet["B1"].Value = "Cost";
sheet["C1"].Value = "Margin";

// Write data
sheet["A2"].Value = 50000;
sheet["B2"].Value = 32000;

// Write a calculated formula
sheet["C2"].Formula = "=A2-B2";

// Apply bold formatting to the header row
sheet["A1:C1"].Style.Font.Bold = true;

// Highlight the margin cell
sheet["C2"].Style.BackgroundColor = "#D4EDDA";
sheet["C2"].Style.Font.Bold = true;

workBook.SaveAs("analytics.xlsx");

Imports IronXL
Imports IronXl.Styles

Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Analytics")

' Write labels
sheet("A1").Value = "Revenue"
sheet("B1").Value = "Cost"
sheet("C1").Value = "Margin"

' Write data
sheet("A2").Value = 50000
sheet("B2").Value = 32000

' Write a calculated formula
sheet("C2").Formula = "=A2-B2"

' Apply bold formatting to the header row
sheet("A1:C1").Style.Font.Bold = True

' Highlight the margin cell
sheet("C2").Style.BackgroundColor = "#D4EDDA"
sheet("C2").Style.Font.Bold = True

workBook.SaveAs("analytics.xlsx")

using IronXL;

// Load a CSV file as if it were a workbook
WorkBook csvWorkBook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkBook.DefaultWorkSheet;

// Apply a bold header style to the first row
csvSheet["A1:Z1"].Style.Font.Bold = true;

// Save as XLSX
csvWorkBook.SaveAs("converted.xlsx");
Console.WriteLine("CSV converted to XLSX.");

using IronXL;

// Load a CSV file as if it were a workbook
WorkBook csvWorkBook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkBook.DefaultWorkSheet;

// Apply a bold header style to the first row
csvSheet["A1:Z1"].Style.Font.Bold = true;

// Save as XLSX
csvWorkBook.SaveAs("converted.xlsx");
Console.WriteLine("CSV converted to XLSX.");

Imports IronXL

' Load a CSV file as if it were a workbook
Dim csvWorkBook As WorkBook = WorkBook.LoadCSV("data.csv", fileFormat:=ExcelFileFormat.CSV)
Dim csvSheet As WorkSheet = csvWorkBook.DefaultWorkSheet

' Apply a bold header style to the first row
csvSheet("A1:Z1").Style.Font.Bold = True

' Save as XLSX
csvWorkBook.SaveAs("converted.xlsx")
Console.WriteLine("CSV converted to XLSX.")

ExcelDataReaderとIronXLを並べて比較するにはどうすれば良いですか？

以下の表は、最も一般的なExcel開発シナリオにおける、2つのライブラリの機能の違いをまとめたものです。

ExcelDataReaderは、読み取りのみが要件であり、バイナリサイズが重要な場合には、依然として有効な選択肢です。 出力を伴うあらゆるシナリオにおいて、 IronXLは最適なツールです。

IronXLはいつ使用すべきですか?

IronXLは、アプリケーションでExcelファイルを作成または変更する必要がある場合に最適な選択肢となります。 以下のシナリオは、ExcelDataReaderでは対応できない実際のビジネス要件を表しています。

-レポート生成：データベースクエリ、APIレスポンス、またはメモリ内計算からExcelレポートを生成します。 詳しい手順については、 Excelレポート作成ガイドを参照してください。 -データエクスポート：アプリケーションデータ（コレクション、データテーブル、データセットなど）をXLSX形式に変換し、ダウンロードまたはアーカイブします。 DataTableからExcelへの変換チュートリアルでは、正確なAPIが示されています。 -テンプレート処理：プレースホルダーセルを含むXLSXテンプレートを読み込み、動的にセルにデータを入力し、入力済みの結果を保存します。 -バッチファイル変更：ワークブックのディレクトリを順に処理し、プログラムで変更を適用して、各ファイルを保存します。IronXLは、複数の開いているワークブックを個別に処理します。 -請求書および財務文書の作成：数式、数値書式設定、セル結合、スタイル付きヘッダーを使用して、構造化された文書を作成します。

• CSVからXLSXへの変換：カンマ区切りのアップロードを受け付け、構造化されたワークブックとして再フォーマットし、XLSX形式でダウンロードできるようにユーザーに返します。

従来、読み取りライブラリと書き込みライブラリの両方が必要だった、あるいはCOMを介したExcel自動化に依存していたビジネスアプリケーションは、 IronXLのみに統合することが可能になります。

高度な出力シナリオについては、条件付き書式設定に関するドキュメントと グラフ作成ガイドに、書式設定と視覚化機能の全範囲が記載されています。 ライセンスページには本番環境への導入オプションが記載されており、完全なAPIリファレンスにはすべてのクラスとメソッドが文書化されています。

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

IronXLは、無料の開発ライセンスで利用可能です。 NuGetパッケージをインストールし、上記の例を自分のファイルに対して実行して、出力が要件を満たしていることを確認してから、製品版ライセンスを契約してください。

IronXLの入門ガイドでは、インストール方法、初回使用時のパターン、実行可能なコードを用いた一般的なシナリオについて解説しています。 チュートリアルセクションでは、読み取りワークフローについて詳しく解説しています。これは、アプリケーションで読み取り操作と書き込み操作の両方が必要な場合に役立ちます。

無料トライアルを開始すると、エクスポート形式、高度な書式設定、数式評価、複数シートのワークブック管理など、すべての機能をご利用いただけます。 大規模な環境でライブラリを評価するチーム向けに、 IronSuiteバンドルにはIronXLに加え、 IronPDF、 IronOCR、その他の生産性向上ライブラリがセットになっており、お得な価格で提供されています。

ExcelDataReaderは今でも使う価値があるのか​​？

ExcelDataReaderは、明確な目的を持った、適切にメンテナンスされているオープンソースライブラリです。 アプリケーションがExcelファイルを読み込むだけで書き込みを行わない場合（例えば、XLSXファイルをデータベースにインポートするデータ取り込みパイプラインなど）、ExcelDataReaderは合理的で軽量な選択肢となります。そのストリーミングモデルは、非常に大きなファイルでもメモリ効率に優れています。

問題は、要求が拡大したときに発生する。 読み取り専用のインポートツールとして始まったアプリケーションは、確認エクスポート、エラーレポート、または元のファイルの修正コピーを生成するように進化することがよくあります。 その時点で、ExcelDataReaderのスコープ境界が障害となり、プロジェクトの途中で読み書き可能なライブラリに移行することは、最初から読み書き可能なライブラリを使用するよりも混乱を招くことになる。

最初からIronXLを選択すれば、どちらのシナリオにも対応できます。 IronXLの読み取りチュートリアルでは、 IronXLを使った読み取りも同様に簡単であることを示しています。セル参照、範囲の反復処理、DataSetのエクスポート、型安全な値へのアクセスはすべて、使い慣れた同じAPIを通じて行われます。

次に何をすべきでしょうか?

ExcelDataReaderは読み取り専用ライブラリです。 その制約は意図的なものであり、変更されることはありません。 プロジェクトでExcelファイルの作成、変更、エクスポート（形式を問わず）が必要な場合は、双方向のExcelアクセスに対応したライブラリが必要です。

IronXLは、Officeへの依存、COM相互運用性の複雑さ、複数のパッケージを脆弱なマルチライブラリスタックに組み合わせることなしに、その機能を提供します。 NuGetからインストールし、既存の読み取りコードをIronXLの同等のメソッドに置き換え、必要に応じて書き込み操作を追加してください。APIは双方向で一貫しています。

IronXLのドキュメントを参照して、ライブラリの全容を理解してください。 Excelファイルの作成、スプレッドシートの作成、既存のワークブックの読み込みなど、特定の作業に関する手順ガイドを確認してください。 制作ライセンスの評価準備が整ったら、価格とライセンスのページに利用可能なすべてのティアが表示されます。