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
}

呼叫 Read() 後，完全不存在等效的 Write() 或 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

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.");

如何在單一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.不w.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.不w.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");

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.");

如何比較ExcelDataReader和IronXL ？

下表總結了這兩個函式庫在最常見的 Excel 開發場景中的功能差異：

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

何時該使用IronXL？

當您的應用程式需要產生或修改 Excel 檔案時， IronXL就是您的理想選擇。 以下場景代表了 ExcelDataReader 無法滿足的實際業務需求：

-報表產生：根據資料庫查詢、API 回應或記憶體計算產生 Excel 報表。 請參閱Excel 報表建立指南，以取得結構化的操作步驟。 -資料匯出：將應用程式資料（集合、資料表或資料集）轉換為 XLSX 以便下載或存檔。 "DataTable to Excel"教學展示了具體的API。 -模板處理：載入帶有佔位符單元格的 XLSX 模板，動態填充它們，然後保存填充後的結果。 -批次檔案修改：遍歷工作簿目錄，以IronXL設計方式套用變更並儲存每個檔案。 IronXL 可以獨立處理多個開啟的工作簿。 -發票和財務文件產生：使用公式、數字格式、合併儲存格和樣式標題建立結構化文件。

• CSV 到 XLSX 轉換：接受逗號分隔的上傳文件，將其重新格式化為結構化工作簿，並將 XLSX 下載返回給使用者。

以前需要讀取庫和寫入庫，或依賴透過 COM 實現 Excel 自動化的業務應用程序，現在可以合併為一個IronXL 。

對於進階輸出場景，條件格式文件和 圖表建立指南涵蓋了所有格式設定和視覺化功能。 許可頁面概述了生產部署選項，完整的 API 參考文件包含了每個類別和方法。

如何開始免費試用？

IronXL採用免費開發許可協議。 安裝NuGet包，針對您自己的檔案執行上述範例，並在購買生產許可證之前驗證輸出是否符合您的要求。

IronXL入門指南通過可運行程式碼，逐步解說安裝、首次使用模式和常見場景。 教程部分詳細介紹了讀取工作流程，如果您的應用程式需要讀取和寫入操作，這將非常有用。

立即開始免費試用，即可體驗全部功能，包括匯出格式、進階格式設定、公式計算和多工作表工作簿管理。 對於大規模評估該庫的團隊， IronSuite 套裝包含IronXL以及IronPDF、 IronOCR和其他生產力庫，組合價格更低。

ExcelDataReader現在還值得使用嗎？

ExcelDataReader 是一個維護良好的開源函式庫，有明確的用途。 如果您的應用程式僅讀取 Excel 檔案而不寫入檔案（例如，將 XLSX 上傳檔案匯入資料庫的資料匯入管道），那麼 ExcelDataReader 是一個合理且輕量級的選擇。它的流式模型對於非常大的檔案來說非常節省記憶體。

當需求增加時，問題就出現了。 最初作為唯讀導入器的應用程式通常會發展成為產生確認匯出、錯誤報告或原始文件修改副本的工具。 此時，ExcelDataReader 的作用域邊界就成了阻礙，在專案進行過程中遷移到讀寫庫比一開始就使用讀寫庫更具破壞性。

從一開始就選擇IronXL可以涵蓋這兩種情況。 IronXL讀取教程表明，使用IronXL讀取資料同樣簡單直接——單元格引用、範圍迭代、資料集導出和類型安全的值存取都透過同一個熟悉的 API 進行操作。

接下來你該怎麼做？

ExcelDataReader 是一個唯讀函式庫。 這種限制是人為設定的，不會改變。 如果您的專案需要以任何形式編寫、修改或匯出 Excel 文件，則需要一個為雙向 Excel 存取而建立的程式庫。

IronXL提供了這種功能，無需 Office 依賴項，無需 COM 互通複雜性，也無需將多個軟體包組合成脆弱的多庫堆疊。 從NuGet安裝，將現有的讀取碼替換為 IronXL 的等效方法，並在需要的地方添加寫入操作——API 在兩個方向上都是一致的。

請查閱IronXL文檔，以了解該庫的全部功能。 查看有關編寫 Excel 檔案、建立電子表格和讀取現有工作簿等特定任務的操作指南。 當您準備評估生產許可時， "定價和許可"頁面會列出所有可用的等級。