C# 中读取 Excel 文件的最佳方法 | IronXL分步指南

在 C# 中读取 Excel 文件的最佳方法是什么？

最佳方法是使用专用的、独立于 Office 的库，例如IronXL。 像 Microsoft.Office.Interop.Excel 这样的传统方法在安装了 Excel 的机器上可以正常工作，但在服务器或容器环境中却很脆弱，因为它们会在后台启动一个 COM 进程。 OpenXML SDK 是免费的，并且对服务器安全，但它公开了一个底层 XML 模型，日常任务需要大量的样板代码。

IronXL 的性能介于这两种极端情况之间。 该 API 反映了开发者对电子表格的固有认知——工作簿包含工作表，工作表包含单元格，单元格包含输入的值。 该库内部处理格式检测、公式计算和编码，因此您可以将时间花在业务逻辑上，而不是解析细节上。

IronXL Excel 读取文档涵盖了完整的 API 接口。 目前，以下各节展示了您在每个项目中都会用到的核心模式。

如何在.NET项目中安装IronXL ？

使用NuGet包管理器安装只需不到一分钟。 在项目目录下打开终端并运行：

dotnet add package IronXl.Excel

dotnet add package IronXl.Excel

或者，使用 Visual Studio 包管理器控制台：

Install-Package IronXl.Excel

Install-Package IronXl.Excel

安装完成后，将 using IronXL; 指令添加到任何需要访问电子表格的文件。 该库面向.NET 10、 .NET 8、 .NET 6、 .NET Framework 4.6.2 和.NET Standard 2.0，因此无需升级运行时即可集成到现有项目中。有关特定平台的说明和NuGet包详细信息，请参阅IronXL安装指南。

无需额外的运行时组件、注册表项或 Office 许可证。 NuGet包包含了库所需的一切。

如何加载和读取Excel工作簿？

加载工作簿只需要调用一个方法。 WorkBook.Load 接受一个文件路径，并返回一个 WorkBook 对象，该对象表示内存中的整个文件。

using IronXL;

// Load any supported format -- XLSX、XLS, or CSV
WorkBook workbook = WorkBook.Load("financial_report.xlsx");

// Access the first worksheet by position
WorkSheet worksheet = workbook.WorkSheets[0];

// Or retrieve a named worksheet
WorkSheet expenses = workbook.GetWorkSheet("Expenses");

Console.WriteLine($"Sheets loaded: {workbook.WorkSheets.Count}");
Console.WriteLine($"Default sheet rows: {worksheet.RowCount}");

using IronXL;

// Load any supported format -- XLSX、XLS, or CSV
WorkBook workbook = WorkBook.Load("financial_report.xlsx");

// Access the first worksheet by position
WorkSheet worksheet = workbook.WorkSheets[0];

// Or retrieve a named worksheet
WorkSheet expenses = workbook.GetWorkSheet("Expenses");

Console.WriteLine($"Sheets loaded: {workbook.WorkSheets.Count}");
Console.WriteLine($"Default sheet rows: {worksheet.RowCount}");

WorkBook 对象可访问所有工作表数据。 每个 WorkSheet 实例都映射到文件中的一个制表符。通过索引 (WorkSheets[0]) 访问单页文件是可靠的； 当文件包含多个名称已知的标签页时，按名称访问更安全。

IronXL会在读取单元格时自动计算公式。 如果单元格 B10 包含 =SUM(B2:B9)，则读取 sheet["B10"].DecimalValue 返回计算出的总计，而不是公式字符串。 有关工作簿加载选项的更多详细信息，请参阅加载电子表格操作指南。

如何读取工作表中的单元格值？

IronXL为每个单元格提供强类型属性，因此您可以直接将值读取到正确的.NET类型中，而无需手动解析。

using IronXL;

WorkBook workbook = WorkBook.Load("Products.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Address-based access with typed properties
string productName = sheet["A2"].StringValue;
int quantity       = sheet["B2"].IntValue;
decimal price      = sheet["C2"].DecimalValue;
bool inStock       = sheet["D2"].BoolValue;

// Check for empty cells before processing
var statusCell = sheet["E2"];
if (statusCell.Value != null && statusCell.StringValue.Length > 0)
{
    Console.WriteLine($"Status: {statusCell.StringValue}");
}

// Row/column index access (zero-based)
var firstDataCell = sheet.Rows[1].Columns[0];
Console.WriteLine($"Product: {productName}, Qty: {quantity}, Price: {price:C}");

using IronXL;

WorkBook workbook = WorkBook.Load("Products.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Address-based access with typed properties
string productName = sheet["A2"].StringValue;
int quantity       = sheet["B2"].IntValue;
decimal price      = sheet["C2"].DecimalValue;
bool inStock       = sheet["D2"].BoolValue;

// Check for empty cells before processing
var statusCell = sheet["E2"];
if (statusCell.Value != null && statusCell.StringValue.Length > 0)
{
    Console.WriteLine($"Status: {statusCell.StringValue}");
}

// Row/column index access (zero-based)
var firstDataCell = sheet.Rows[1].Columns[0];
Console.WriteLine($"Product: {productName}, Qty: {quantity}, Price: {price:C}");

使用IronXL在 C# 中读取 Excel 文件的最佳方法：图 2 - 使用IronXL读取 Excel 文件输出

sheet["A2"] 语法使用标准的 Excel 表示法。 列字母不区分大小写，行号从 1 开始，与 Excel 标记单元格的方式一致。 单元格值读取文档显示了其他类型访问器，包括 DateTimeValue，用于格式化为日期的单元格。

当单元格包含以文本形式存储的数字时(这是导出电子表格中常见的数据质量问题)，StringValue 会按原样返回文本，而 DecimalValue 会尝试解析，并在解析失败时返回 0。 在生产代码中将意外数据作为类型化值处理之前，务必先对其进行验证。

如何遍历行和单元格？

遍历数据集需要一个范围或行集合。 IronXL支持这两种方法，您可以将它们结合起来以匹配数据的形状。

using IronXL;

WorkBook workbook = WorkBook.Load("financial_report.xlsx");
WorkSheet sheet = workbook.WorkSheets[0];

// Iterate a cell range -- skips header row
foreach (var cell in sheet["A2:D100"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Row-by-row with column access
for (int rowIndex = 1; rowIndex < sheet.RowCount; rowIndex++)
{
    var row = sheet.Rows[rowIndex];
    var values = new System.Text.StringBuilder();

    foreach (var cell in row)
    {
        if (cell.Value != null)
            values.Append($"{cell.StringValue}\t");
    }

    Console.WriteLine(values.ToString().TrimEnd());
}

using IronXL;

WorkBook workbook = WorkBook.Load("financial_report.xlsx");
WorkSheet sheet = workbook.WorkSheets[0];

// Iterate a cell range -- skips header row
foreach (var cell in sheet["A2:D100"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Row-by-row with column access
for (int rowIndex = 1; rowIndex < sheet.RowCount; rowIndex++)
{
    var row = sheet.Rows[rowIndex];
    var values = new System.Text.StringBuilder();

    foreach (var cell in row)
    {
        if (cell.Value != null)
            values.Append($"{cell.StringValue}\t");
    }

    Console.WriteLine(values.ToString().TrimEnd());
}

范围字符串 "A2:D100" 创建一个扁平单元格集合。 该范围内的行按从上到下、从左到右的顺序处理。 这种模式非常适合导出到 DataTable 或数据库。

sheet.RowCount 属性反映工作表中最后使用的行，因此当数据结束时循环会自动终止。 迭代 Excel 范围指南涵盖了其他迭代模式，包括列优先遍历。

如何处理多种Excel格式？

IronXL会自动根据文件扩展名和文件头检测文件格式。 XLSX、XLS 和 CSV 文件的 API 完全相同，这意味着相同的解析代码无需条件逻辑即可应用于所有三种格式。

using IronXL;

// Load different formats with identical API
WorkBook xlsxBook = WorkBook.Load("Modern.xlsx");
WorkBook xlsBook  = WorkBook.Load("Legacy.xls");
WorkBook csvBook  = WorkBook.Load("Export.csv");

// Access worksheets identically across formats
WorkSheet sheet1 = xlsxBook.DefaultWorkSheet;
WorkSheet sheet2 = xlsBook.DefaultWorkSheet;
WorkSheet sheet3 = csvBook.DefaultWorkSheet;

// Cross-format conversion -- save XLSX as CSV, or CSV as XLSX
xlsxBook.SaveAs("converted_output.csv");
csvBook.SaveAs("structured_output.xlsx");

Console.WriteLine($"XLSX rows: {sheet1.RowCount}");
Console.WriteLine($"XLS rows:  {sheet2.RowCount}");
Console.WriteLine($"CSV rows:  {sheet3.RowCount}");

using IronXL;

// Load different formats with identical API
WorkBook xlsxBook = WorkBook.Load("Modern.xlsx");
WorkBook xlsBook  = WorkBook.Load("Legacy.xls");
WorkBook csvBook  = WorkBook.Load("Export.csv");

// Access worksheets identically across formats
WorkSheet sheet1 = xlsxBook.DefaultWorkSheet;
WorkSheet sheet2 = xlsBook.DefaultWorkSheet;
WorkSheet sheet3 = csvBook.DefaultWorkSheet;

// Cross-format conversion -- save XLSX as CSV, or CSV as XLSX
xlsxBook.SaveAs("converted_output.csv");
csvBook.SaveAs("structured_output.xlsx");

Console.WriteLine($"XLSX rows: {sheet1.RowCount}");
Console.WriteLine($"XLS rows:  {sheet2.RowCount}");
Console.WriteLine($"CSV rows:  {sheet3.RowCount}");

对于 CSV 文件， IronXL遵循 RFC 4180 约定，包括包含逗号的带引号字段、带引号的值中的换行符以及转义的双引号。 CSV 转 XLSX 转换指南涵盖了非标准 CSV 导出的分隔符​​自定义。

当您的应用程序必须从外部系统接收文件时，最佳实践是在加载之前检查文件扩展名并验证文件内容。 如果文件损坏或格式不受支持， IronXL会抛出一个描述性异常，您可以捕获该异常并将其显示给用户。

如何在 Excel 数据上运行高级查询？

除了逐个单元格读取之外， IronXL还提供了聚合函数和 LINQ 兼容性，可以将工作表范围转换为可查询的集合。

using IronXL;
using System.Linq;

WorkBook workbook = WorkBook.Load("Financials.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Built-in aggregates -- no manual looping needed
decimal totalSales = sheet["B2:B50"].Sum();
decimal maxRevenue = sheet["C2:C50"].Max(c => c.DecimalValue);
decimal avgMargin  = sheet["D2:D50"].Avg();

// LINQ filtering directly on a range
var highValueRows = sheet["C2:C50"]
    .Where(c => c.DecimalValue > 1000)
    .Select(c => new { c.AddressString, c.DecimalValue });

foreach (var row in highValueRows)
    Console.WriteLine($"高的 value at {row.AddressString}: {row.DecimalValue:C}");

// Write a calculated result back to the sheet
sheet["E2"].Value = totalSales;
workbook.SaveAs("Financials_Updated.xlsx");

Console.WriteLine($"Total: {totalSales:C}, Max: {maxRevenue:C}, Avg: {avgMargin:C}");

using IronXL;
using System.Linq;

WorkBook workbook = WorkBook.Load("Financials.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Built-in aggregates -- no manual looping needed
decimal totalSales = sheet["B2:B50"].Sum();
decimal maxRevenue = sheet["C2:C50"].Max(c => c.DecimalValue);
decimal avgMargin  = sheet["D2:D50"].Avg();

// LINQ filtering directly on a range
var highValueRows = sheet["C2:C50"]
    .Where(c => c.DecimalValue > 1000)
    .Select(c => new { c.AddressString, c.DecimalValue });

foreach (var row in highValueRows)
    Console.WriteLine($"高的 value at {row.AddressString}: {row.DecimalValue:C}");

// Write a calculated result back to the sheet
sheet["E2"].Value = totalSales;
workbook.SaveAs("Financials_Updated.xlsx");

Console.WriteLine($"Total: {totalSales:C}, Max: {maxRevenue:C}, Avg: {avgMargin:C}");

当您需要在将行导入数据库之前对其进行筛选，或者验证列中的所有值是否都满足阈值时，LINQ 兼容性非常有用。 该库在 LINQ 运行之前会评估公式，因此聚合查询始终对最终计算值进行操作，而不是对公式字符串进行操作。

IronXL的 LINQ 教程涵盖了连接工作表、按列分组以及将结果投影到强类型对象——这些模式可以消除数据管道代码中的大量样板代码。

如何将Excel数据导出到DataTable？

许多.NET应用程序将电子表格数据加载到 ADO.NET DataTable 中，以便进行进一步处理或插入数据库。 IronXL提供了一种直接转换方法，无需手动进行列映射。

using IronXL;
using System.Data;

WorkBook workbook = WorkBook.Load("SalesData.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Convert worksheet to DataTable -- first row becomes column headers
DataTable dataTable = sheet.ToDataTable(true);

Console.WriteLine($"Columns: {dataTable.Columns.Count}");
Console.WriteLine($"Rows:    {dataTable.Rows.Count}");

// Iterate the DataTable normally
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"{row["ProductName"]} -- {row["Quantity"]} -- {row["Price"]}");
}

using IronXL;
using System.Data;

WorkBook workbook = WorkBook.Load("SalesData.xlsx");
WorkSheet sheet = workbook.DefaultWorkSheet;

// Convert worksheet to DataTable -- first row becomes column headers
DataTable dataTable = sheet.ToDataTable(true);

Console.WriteLine($"Columns: {dataTable.Columns.Count}");
Console.WriteLine($"Rows:    {dataTable.Rows.Count}");

// Iterate the DataTable normally
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"{row["ProductName"]} -- {row["Quantity"]} -- {row["Price"]}");
}

将 true 传递给 ToDataTable 会将工作表的第一行视为列标题。 生成的 DataTable 使用与标题文本匹配的字符串列名，使后续的 LINQ to DataSet 查询更易读。 DataTable 导出文档涵盖了空值处理和类型推断选项。

当下游代码已经期望 DataTable 时，这种模式特别有用——例如，当调用 SqlBulkCopy 将行插入 SQL Server 时。 您可以加载 XLSX 文件，将其转换为 DataTable，然后进行批量插入，而无需编写任何列映射样板代码。

有关完整的 API 列表，请参阅IronXL API 参考。 该参考文档涵盖了每个属性和方法，包括参数描述和返回类型详情。

下一步计划是什么？

只要有了合适的库，用 C# 读取 Excel 文件就非常简单。 IronXL消除了对 Office 的依赖，简化了 API 接口，并且使用相同的代码路径处理 XLSX、XLS 和 CSV 格式。 这里涵盖的模式——加载工作簿、读取键入的单元格值、迭代范围、运行聚合以及导出到 DataTable——涵盖了大多数现实世界的电子表格读取需求。

为了继续沿用这些模式：

• 阅读IronXL入门文档，了解项目设置指南和运行时要求。
• 探索有关写作、格式设置和图表生成的操作指南。
• 查看Excel 公式支持指南，了解IronXL会自动计算哪些 Excel 函数。
• 请查看IronXL许可页面，了解生产部署选项。
• 浏览IronXL博客，查看有关数据验证、数据透视表导出和密码保护文件处理的示例。

对于正在评估IronXL与其他库的团队来说， IronXL与 EPPlus 的比较以及IronXL与 NPOI 的比较涵盖了性能基准和 API 差异。 两项比较都包含了每个库中等效操作的代码示例。

如果您遇到来自旧系统的不寻常的电子表格结构，微软自己的Excel 文件格式规范是一个有用的参考。 ECMA-376 标准定义了 XLSX 文件遵循的 OOXML 格式。

在购买正式版许可证之前，您可以先申请IronXL免费试用许可证，在您自己的项目中测试完整的 API。