ExcelDataReader 写 Excel 文件：为什么不能以及 IronXL 如何解决这个问题

ExcelDataReader能写入Excel工作簿数据吗？

ExcelDataReader 无法写入 Excel 文件：原因及 IronXL 的解决方案：图 1 - ExcelDataReader

不。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

调用 Read() 后，根本不存在等效的 Write() 或 Save() 对应项。 当您的应用程序需要生成报表、更新电子表格单元格、将数据导出为 XLSX、应用公式或处理模板时，ExcelDataReader 为您提供了丰富的工具箱。

这不是一个错误。 这是经过深思熟虑的范围决定。 ExcelDataReader 只专注于做好一件事，仅此而已。 任何涉及将数据写回 Excel 的工作流都需要完全不同的库。

IronXL如何解决写入问题？

! ExcelDataReader 写入 Excel 文件：为什么无法写入以及 IronXL 如何解决此问题：图 2 - IronXL

IronXL 提供了一个统一的 API，无需安装 Microsoft Office 即可读取、创建、修改和保存 Excel 文件。 该库将 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 仅处理第一步，这意味着您需要引入第二个库——这种不必要的复杂性会增加依赖项管理的负担，并可能引发版本冲突。

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

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 转 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 文件、创建电子表格以及读取现有工作簿。 当您准备评估生产版许可时，定价与许可页面列出了所有可用的许可层级。