IRONXLの使用

`ExcelDataReader` が Excel ファイルを書き込めない理由とIronXL がこれを解決する方法

Curtis Chau
Curtis Chau
Updated: 2026年6月28日

ExcelDataReader はExcelファイルを読み取ることしかできず、書き込むことはできません。 IronXLは、書き込み機能を含むExcelの完全な操作を実現するために、読み取りと書き込みの両方の操作をシームレスに処理する包括的なソリューションを提供します。

多くの開発者は、C＃でExcelファイルを扱う軽量ソリューションを探しているときに ExcelDataReader を発見します。 しかし、名前が完全なExcel機能を示唆しているにもかかわらず、ExcelDataReader はExcelファイルに書き込むことはできないという基本的な制限にすぐに直面します。 この記事では、このよくある誤解を解消し、 Excel文書の読み書きをシームレスに処理できる包括的な代替ツールとしてIronXLを紹介します。 このガイドの目的は、Excelの文書作成要件に分かりやすく対応できるよう支援することです。

このガイドでは、ExcelDataReader がExcelファイルに書き込めない理由、そしてIronXLがその制限をどのように解決するか、さらに動作するコード例を使用した開始方法を学びます。 さらに、 CSVデータの変換方法、配列オブジェクトを使った列へのデータ入力方法、さまざまなエンコードオプションを使った異なるファイル形式間でのデータ受け渡し方法も学ぶことができます。 ASP.NETアプリケーションを構築する場合でも、 .NET MAUIを扱う場合でも、これらの制限を理解することは、適切なライブラリを選択する上で非常に重要です。

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

ExcelDataReader GitHubリポジトリのスクリーンショットには、プロジェクトの説明、構築状況、およびその読み取り専用性を強調したサポートされているExcelファイル形式のテーブルが表示されています

いいえ、ExcelDataReader はExcelファイルに書き込むことができません。 このライブラリは、様々な形式（XLS、XLSX、CSV）のExcelドキュメントを読み込むためだけに設計されています。 これはC#でExcelファイルを読み込むための高速ライブラリではありますが、その用途はExcelファイル読み込みに限られます。 公式のGitHubリポジトリには、書き込み機能はなく、"Microsoft Excelファイルを読み込むためのライブラリ"であると明記されている。 パッケージをインストールしてプロジェクト内でDLLを参照すると、書き込み時のエンコーディングの処理、データ問題の修正のための行のスキップ、汎用コレクション内の列名や整数値の操作ができないことがわかります。

ここでは、ExcelDataReader が新しい ExcelReaderConfiguration インスタンスを必要とし、サーバー展開のためのファイルパスとメモリ設定を処理できることを示します。

using ExcelDataReader;
using System.IO;
// ExcelDataReader can ONLY read files
using (var stream = File.Open("data.xlsx", FileMode.Open, FileAccess.Read))
{
    using (var reader = ExcelReaderFactory.CreateReader(stream))
    {
        // Read data from Excel
        while (reader.Read())
        {
            var value = reader.GetString(0); // Read cell value
        }
        // But there's no way to write back to the file
    }
}

このコードは、ExcelDataReader の読み取り専用の性質を示しています。 このライブラリはExcelファイルからデータを効率的に抽出しますが、Write()、Save()、または SetCellValue() といったメソッドを提供しません。 レポートの作成、スプレッドシートの更新、新しい Excel ファイルの生成、情報の記録、他のシステムへの結果の投稿、セルへのコメントの追加、LINQ クエリの実装、タグやメタデータの入力などを行う必要がある開発者は、別の方法を探す必要があります。 この制限は、データをExcelにエクスポートしたり、プログラムでExcelグラフを作成したりする必要がある場合に特に顕著になります。

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

IronXL for .NETのホームページには、Microsoft Officeを使わずにExcelファイルを読み書きするためのC#コード例と、ダウンロードオプションや包括的な機能が紹介されています

IronXL は完全な Excel 操作機能を提供するため、開発者は Microsoft Office に依存せずに Excel ファイルを読み取り、作成、編集、保存できます。 読み取り専用ソリューションとは異なり、IronXL は Excel ファイルを完全に編集可能なドキュメントとして扱います。 このシンプルな方法を使えば、CSVデータの変換、フォーマット間の変換、シートへのデータ入力などをスムーズに行うことができます。 このライブラリは、Windows 、 macOS 、さらにはDockerコンテナなど、さまざまなプラットフォームをサポートしています。

IronXLを使い始めるには?

IronXL をインストールするには、1 つの NuGet コマンドだけが必要です。

PM > Install-Package IronXL.Excel

基本的な実装は、一般的なパターンに従います。

using IronXL;
// Your first IronXL application
class Program
{
    static void Main()
    {
        // Create workbook
        WorkBook workBook = WorkBook.Create();
        WorkSheet sheet = workBook.CreateWorkSheet("Data");    
        // Write your data
        sheet["A1"].Value = "Hello Excel";
        // Save to file
        workBook.SaveAs("output.xlsx");
    }
}

ここでは、簡単に新しい Excel ブックと"データ"という名前の新しい Excel シートを作成しました。 この新しいシートでは、 CSVファイル、データテーブル、データセット、その他のデータソースから簡単にデータを追加できます。 .NET Coreプラットフォームでは、区切り文字で区切られたファイルと様々なエンコード形式がサポートされています。 IronXLは、 Excelのメタデータとワークシートの管理もシームレスに処理します。

開発者が ExcelDataReader から移行する際には、読み取り専用操作をIronXLの読み書きメソッドに置き換える必要があります。 IronXL は Excel のセル参照システムを反映した直感的な構文を使用するため、学習曲線は最小限です。 セルの範囲を簡単に選択したり、書式設定を適用したり、ハイパーリンクを追加したりできます。

IronXLの全機能を体験するには、無料トライアルを開始するか、詳細な例やAPIリファレンスについては包括的なドキュメントを参照してください。

基本的な筆記操作はどのように行うのですか？

IronXL を使用したExcel ファイルの作成と書き込みは簡単です。

using IronXL;
// Create a new Excel file
WorkBook workBook = WorkBook.Create();
WorkSheet sheet = workBook.CreateWorkSheet("Report");
// Write values to specific cells
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 100;
// Save the file
workBook.SaveAs("inventory.xlsx");

この例では、新しいブックを作成し、特定のセルにデータを追加して、結果を保存します。 直感的なセル アドレス指定 (sheet["A1"]) により、コードが読みやすく、保守しやすくなります。 CSVファイルへの書き込みや、既存のExcelファイルをインポートして編集することも可能です。

Excelスプレッドシートには書式付き見出しとサンプルデータエントリを持つシンプルな製品在庫表が表示され、基本的な書き込み機能が示されています

どのような高度な執筆機能が利用できますか？

IronXL は基本的なセル書き込みを超えて、複雑な Excel 操作をサポートします。

// Write formulas
sheet["C1"].Value = "Total";
sheet["C2"].Formula = "=B2*1.5";
// Write ranges efficiently
sheet["A3:A10"].Value = "Item";
// Apply formatting while writing
sheet["B2"].Style.Font.Bold = true;
sheet["B2"].Style.BackgroundColor = "#FFFF00";
// Add borders and alignment
sheet["A1:C1"].Style.Border.TopBorder = IronXL.Styles.BorderType.Thick;
sheet["A1:C1"].Style.HorizontalAlignment = IronXL.Styles.HorizontalAlignment.Center;

これらの機能により、開発者は計算や書式設定を備えたプロフェッショナルな Excel レポートをプログラムで生成できます。 IronXLは、数式の編集、セルスタイルの適用、データ形式の設定をサポートしています。 条件付き書式やExcel グラフなどのより高度な機能については、IronXL が包括的なドキュメントを提供しています。 セルを結合したり、ウィンドウ枠を固定したりすることで、より見やすいデータ表示を実現することもできます。

Excelスプレッドシートに製品の数量と、数式を使用して計算された合計、境界線や色を含む書式設定が適用され、高度な書き込み機能が示されています

その他の高度な機能には、行と列の自動サイズ調整、背景パターンと色、境界線の配置などがあります。 IronXLは、より整理されたスプレッドシート構造を実現するために、名前付き範囲と名前付きテーブルもサポートしています。

実装の違いは何ですか?

典型的なワークフローを比較すると、根本的な違いが明らかになります。 一般的な要件として、1 つの Excel ファイルからデータを読み取り、変更したバージョンを作成することを考えてみましょう。 このシナリオは、VB .NET Excel ファイルを扱う場合や、スプレッドシート ファイル形式間で変換する必要がある場合によく発生します。

なぜ ExcelDataReader のアプローチは不十分なのか？

// Read with ExcelDataReader
List<string> data = new List<string>();
using (var stream = File.Open("source.xlsx", FileMode.Open))
{
    using (var reader = ExcelReaderFactory.CreateReader(stream))
    {
        while (reader.Read())
        {
            data.Add(reader.GetString(0));
        }
    }
}
// Cannot write back to Excel - need another library!

この制限は、セルをクリアしたり、セルをコピーしたり、何らかの変更操作を実行したりする必要がある場合に問題となります。 ExcelDataReader のアーキテクチャは、出力操作をサポートしていないだけです。

IronXLはどのようにして包括的なソリューションを提供するのか？

// Read and write with IronXL
WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;
// Read existing data
string originalValue = sheet["A1"].StringValue;
// Modify and add new data
sheet["A1"].Value = originalValue.ToUpper();
sheet["B1"].Value = DateTime.Now;
// Add rows and columns dynamically
sheet.InsertRow(2); // Insert a new row at position 2
sheet.InsertColumn(3); // Insert a new column at position C
// Save as new file
workBook.SaveAs("modified.xlsx");

IronXL は、すべての Excel 操作に統合された API を提供します。 これにより、複数のライブラリを混在させる必要がなくなり、複雑さが軽減され、潜在的な互換性の問題も軽減されます。 簡単なメソッド呼び出しで、行や列の追加、セル範囲の並べ替え、さらには行や列のグループ化やグループ解除を行うことができます。

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

アプリケーションで次の要件が求められる場合、IronXL が不可欠になります。

*レポート生成：データベースクエリまたはAPIレスポンスからExcelレポートを作成する *データエクスポート:アプリケーションデータとCSVデータをExcel形式に変換してユーザーに提供します *テンプレート処理： Excelテンプレートへの動的データの入力 *スプレッドシートの自動化：既存ファイルを新しい情報で更新する *バッチ処理：複数のExcelファイルをプログラムで変更する

これらのシナリオは、ExcelDataReader だけでは不可能です。 ExcelDataReader は既存のファイルからデータを抽出するのに優れていますが、Excelドキュメントの生成や変更が要求される場合には、書き込み機能を備えたライブラリが必要です。 データの変換、配列オブジェクトからの列名の入力、書式設定の問題の修正、変更の記録、またはサーバーへの結果の投稿を行うソリューションを実装する必要がある場合、IronXL は完全なツールセットを提供します。 このライブラリはBlazorアプリケーションもサポートしており、 Excel Interopなしでも動作します。

ビジネス アプリケーションは特に IronXL の包括的な機能から恩恵を受けます。 請求書の作成、在庫レポートの作成、財務諸表の作成など、ソース データの読み取りとフォーマットされた出力の書き込みの両方の機能により、開発が効率化されます。 IronXLのライセンスモデルは、さまざまな導入シナリオに対応できる柔軟性を備えており、ライブラリは高いセキュリティ基準を維持しています。

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

ExcelDataReader は、Excelファイルを効率的に読み取る特定の目的に役立ちます。 ただし、最近のアプリケーションでは通常、双方向の Excel 対話が必要です。 IronXL は、単一の統合ライブラリで完全な Excel 操作機能を提供することで、このニーズに対応します。 開発者は、複数のツールを組み合わせたり、制限を回避したりする代わりに、1 つの一貫した API を使用してすべての Excel 操作を処理できます。 ライブラリは定期的なアップデートとパフォーマンス改善により、常に最新の状態に保たれています。

読み取り専用の Excel 操作を超える準備はできていますか? IronXL の無料トライアルを開始して、.NET アプリケーションでの完全な Excel コントロールを体験してください。 実稼働環境での使用には、専用のサポートと展開の柔軟性を含むライセンス オプションを検討してください。 開始にあたってサポートが必要ですか? スムーズな導入のために、ライセンスキー申請ガイドとトラブルシューティング資料をご確認ください。

Curtis Chau
Curtis Chau
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

詳しく読む

関連する記事