跳至页脚内容
使用 IRONXL

如何在 C# 中导入、读取及操作 Excel 数据

许多 C# 开发人员在尝试读取 Excel 表格文件时都会遇到一个共同的挑战:他们信赖的 StreamReader 可以完美地处理文本文件,但却无法处理 Excel 文档,这令人费解。 如果你尝试使用 C# 中的 StreamReader 读取 Excel 文件,却只看到乱码或异常,那么你并不孤单。 本教程解释了为什么 StreamReader 不能直接处理 Excel 文件,并演示了不使用 Excel Interop 的 IronXL 的正确解决方案。

这种混淆通常是因为 Excel 可以打开 CSV 文件,而 StreamReader 也可以正常打开 CSV 文件。 然而,真正的 Excel 文件(XLSX、XLS)需要采用完全不同的方法。 理解这一区别将为您节省数小时的调试时间,并引导您找到完成这项工作的正确工具。

如何在 C# 中导入、读取和操作 Excel 数据:图 1 - IronXL

为什么 StreamReader 无法读取 Excel 文件?

StreamReader 专为纯文本文件设计,使用指定的编码逐行读取字符数据。 Excel 文件虽然看起来像电子表格,但实际上是 StreamReader 无法解释的复杂二进制或 ZIP 压缩 XML 结构。

static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // read data
    Console.WriteLine(content); // Outputs garbled binary data
 }
}
static void Main(string[] args)
{
 // This code will NOT work - demonstrates the problem
 using (StreamReader reader = new StreamReader("ProductData.xlsx"))
 {
    string content = reader.ReadLine(); // read data
    Console.WriteLine(content); // Outputs garbled binary data
 }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

当您运行此类程序代码片段时,您将不会看到电子表格数据,而是会遇到二进制未知数据,例如"PK♥♦"或类似的系统字符。 这是因为 XLSX 文件是包含多个 XML 文件的 ZIP 压缩文件,而 XLS 文件使用专有的二进制格式。 StreamReader 期望的是纯文本,并尝试将这些复杂的结构解释为字符,从而导致输出毫无意义。

示例输入

如何在 C# 中导入、读取和操作 Excel 数据:图 2 - Excel 输入

输出

如何在 C# 中导入、读取和操作 Excel 数据:图 3 - 控制台输出

现代 Excel 文件 (XLSX) 包含多个组件:工作表、样式、共享字符串和关系,所有这些都打包在一起。 这种复杂性需要能够理解 Excel 文件结构的专用库,这就引出了 IronXL。

如何使用 IronXL 读取 Excel 文件?

IronXL为使用 C# 读取 Excel 文件提供了一个简单的解决方案。 与 StreamReader 不同,IronXL 了解 Excel 的内部结构,并提供直观的方法来访问您的数据。 该库支持 Windows、Linux、macOS 和 Docker 容器,使其成为现代跨平台应用程序的理想选择。

如何在 C# 中导入、读取和操作 Excel 数据:图 4 - 跨平台

首先,通过 NuGet 包管理器安装 IronXL:

Install-Package IronXL.Excel

如何在 C# 中导入、读取和操作 Excel 数据:图 5 - 安装

以下是正确读取Excel文件的方法:

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}
using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

这段代码可以成功加载您的 Excel 文件,并提供对单元格值的直接访问。 WorkBook.Load 方法会自动检测文件格式(XLSX、XLS、XLSM、CSV),并在内部处理所有复杂的解析。 您可以使用熟悉的 Excel 表示法(例如"A1")或范围(例如"A1:C5")来访问单元格,这使得熟悉 Excel 的人能够直观地理解代码。

如何从内存流中读取Excel?

实际应用中经常需要处理来自数据流而不是磁盘文件的 Excel 文件。 常见场景包括处理网页上传、从数据库检索文件或处理来自云存储的数据。 IronXL能够优雅地处理这些情况:

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a new DataTable, return dt
    var dataTable = worksheet.ToDataTable(false);
    // Return DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}
using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a new DataTable, return dt
    var dataTable = worksheet.ToDataTable(false);
    // Return DataTable row count 
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

WorkBook.FromStream 方法接受任何流类型,无论是 MemoryStream、FileStream 还是网络流。 这种灵活性使您无需先将 Excel 文件保存到磁盘即可处理来自各种来源的文件。该示例还演示了如何将工作表数据转换为 DataTable,DataTable 可以与数据库和数据绑定场景无缝集成。

输出

如何在 C# 中导入、读取和操作 Excel 数据:图 6 - 从 MemoryStream 输出读取 Excel 数据

何时使用对象发送器读取数据?

在事件驱动编程中使用此代码的情况下(例如,在 Windows Forms 或 ASP.NET 中处理文件上传按钮),该方法签名通常包含诸如 object sender 和 EventArgs 之类的参数。 此上下文可确保 Excel 处理逻辑与 UI 或服务事件正确关联。

如何在 C# 中导入、读取和操作 Excel 数据:图 7 - 功能

如何在Excel和CSV之间进行转换?

虽然 StreamReader 可以处理 CSV 文件,但您经常需要在 Excel 和 CSV 格式之间进行转换。 IronXL 使这种转换变得非常简单:

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");
using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

这些转换操作会在更改文件格式的同时保留您的数据。 将 Excel 转换为 CSV 时,IronXL 默认会将第一个工作表展平,但您可以指定要导出的工作表。 将 CSV 文件转换为 Excel 文件会生成格式正确的电子表格,该电子表格可以保留数据类型,并支持将来进行格式设置和添加公式。

结论

StreamReader 无法处理 Excel 文件,其根本原因在于纯文本与 Excel 复杂的文件结构之间存在根本差异。 虽然 StreamReader 可以完美地处理 CSV 和其他文本格式,但真正的 Excel 文件需要像 IronXL 这样能够理解其中二进制和 XML 结构的专用库。

IronXL 凭借其直观的 API、全面的格式支持和无缝的流处理功能,提供了一个优雅的解决方案。 无论您是构建 Web 应用程序、桌面软件还是云服务,IronXL 都能在所有平台上可靠地处理 Excel 文件。

如何在 C# 中导入、读取和操作 Excel 数据:图 8 - 许可

准备好开始正确使用Excel文件了吗? 下载最符合您项目需求的 IronXL 免费试用版

常见问题解答

为什么StreamReader不能直接在C#中处理Excel文件?

StreamReader是为文本文件设计的,不支持Excel文件的二进制格式,这就是为什么您使用它读取Excel文档时可能会遇到乱码或异常的原因。相反,建议使用像IronXL这样的库来正确处理Excel文件。

在C#中导入Excel数据的推荐方法是什么?

在C#中导入Excel数据的推荐方法是使用IronXL。它允许开发人员无须Excel Interop即可读取和操作Excel文件,提供了更直接和高效的解决方案。

我可以在C#中不使用Excel Interop操作Excel文件吗?

是的,您可以通过使用IronXL来在C#中操作Excel文件,而无需Excel Interop。它提供了一种在您的C#应用程序中直接处理Excel文档的无缝方式。

使用IronXL处理Excel文件的好处是什么?

IronXL提供了多种好处,包括无需Microsoft Excel即可读写Excel文件,支持多种Excel格式,并且具有简化数据操作任务的强大API。

IronXL是否支持读取具有复杂数据类型的Excel文件?

是的,IronXL支持读取具有复杂数据类型的Excel文件,使您能够在C#应用程序中高效地处理多样的数据结构。

IronXL如何改进在C#中处理Excel文件的过程?

IronXL通过提供一个易于使用的接口来简化处理Excel文件的过程,消除了对Excel Interop的需求,减少了代码的复杂性,并提高了性能。

使用IronXL是否可以以不同格式读写Excel文件?

是的,IronXL支持多种Excel文件格式,如XLSX、XLS、CSV等,使您能够轻松地以各种格式读写文件。

IronXL 能高效处理大型 Excel 文件吗?

IronXL旨在高效处理大型Excel文件,提供强大的性能并在文件操作期间最大限度地减少内存使用。

是什么让IronXL成为C#开发人员处理Excel文件的合适选择?

IronXL是C#开发人员的合适选择,因为它提供了一整套用于轻松读取、写入和操作Excel文件的功能,无需Microsoft Excel或复杂的Interop依赖。

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外,Curtis 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。