ExcelDataReader 無法寫入 Excel 檔案：原因及 IronXL 如何解決此問題

ExcelDataReader能寫入Excel工作簿資料嗎？

否。ExcelDataReader是一個設計上只讀的程式庫，而這一限制是有意為之的。 ExcelDataReader的官方GitHub儲存庫將該專案明確描述為"一個用於讀取Microsoft Excel文件的程式庫"——沒有寫入API，沒有保存方法，也沒有任何公開表面上可用的單元格值設置器。 您可以自行驗證這一點，方法是瀏覽ExcelDataReader NuGet套件頁面，其中套件描述強調了其只讀範圍。

ExcelDataReader支持XLS、XLSX和CSV格式的讀取，並有效地完成這項工作。 該程式庫採用類似於ADO.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

調用過Save()對應操作。 當您的應用程式需要生成報告、更新電子表格單元格、將資料導出到XLSX、應用公式或處理模板時，ExcelDataReader將使您面臨一個空的工具箱。

這不是一個漏洞。 這是一個故意的作用範圍決定。 ExcelDataReader專注做好一件事，然後停止於此。 任何涉及將資料寫回到Excel的工作流程都需要一個完全不同的程式庫。

IronXL 如何解決寫入問題？

IronXL提供了一個統一的API來讀取、建立、修改和保存Excel文件，而不需安裝Microsoft Office。 該程式庫將Excel工作簿作為一個完全可變的、記憶體中的物件圖。 您可以載入或建立一個工作簿，通過引用導航到任何單元格，設置值或公式，應用樣式，然後調用SaveAs()——這一工作流程反映了人類在Excel本身中工作的方式。

IronXL支持XLSX、XLS、CSV、TSV和JSON格式作為輸入和輸出。 它在.NET 10、.NET Standard和.NET Framework上運行，適合用於控制台應用程式、ASP.NET Core web API、桌面工具和後台處理服務。

Install-Package IronXL.Excel

dotnet add package IronXL.Excel

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只處理第一步，這意味著您需要引入第二個程式庫——這是沒有必要的複雜化，增加了依賴管理的負擔和潛在的版本衝突。

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開發場景中的能力差異：

當僅僅需要讀取並且二元檔案大小很重要時，ExcelDataReader仍然是合法的選擇。 對於任何涉及輸出的場景，IronXL是合適的工具。

何時應使用 IronXL？

當您的應用程式需要生成或修改Excel文件時，IronXL成為正確的選擇。 以下場景代表了ExcelDataReader無法解決的真實商業需求：

• 報告生成：從資料庫查詢、API響應或記憶體計算生成Excel報表。 請參閱Excel報告生成指南以獲得結構化的操作指導。
• 資料匯出：將應用程式資料——集合、DataTables或DataSets——轉換為可下載或存檔的XLSX。 DataTable to Excel 教程顯示了確切的API。
• 模板處理：讀取具有佔位符單元格的XLSX模板，動態填充，然後保存填充後的結果。
• 批量文件修改：遍歷一本目錄中的工作簿，以程式化方式進行更改，並保存每個文件。IronXL可獨立處理多個打開的工作簿。
• 發票和財務文件生成：構建具有公式、數字格式、合併單元格和樣式化標題的結構化文件。
• CSV到XLSX轉換：接受逗號分隔的上傳，將它們重新格式化為結構化工作簿，並返回XLSX下載給使用者。

以前需要一個讀取程式庫加上一個寫入程式庫的商業應用程式——或依賴於通過COM自動化Excel——如今只需IronXL即可。

對於高級輸出場景，條件格式化文件和圖表建立指南涵蓋了格式化和可視化功能的全部範圍。 授權頁面概述了生產部署選項，而完整API參考文件記錄了每個類和方法。

如何開始免費試用？

IronXL在免費的開發授權下可用。 安裝NuGet包，對您自己的文件運行上述範例，並在承諾購買生產授權之前驗證輸出是否符合您的要求。

IronXL入門指南將逐步介紹安裝、首次使用模式以及與可運行程式碼的常見情景。 教程部分詳細介紹了讀取工作流程，這在您的應用程式需要同時讀寫操作時尤其有用。

開始免費試用以存取完整功能，包括匯出格式、高級格式化、公式評估和多工作表工作簿管理。 對於大規模評估程式庫的團隊，Iron Suite捆綁包包含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文件、建立電子表格和讀取現有工作簿。 當您準備好評估生產授權時，定價和授權頁面列出了所有可用的級別。