C#使用Spire.XLS读取Excel数据的代码示例
作者：LSTM97
引言
在现代企业应用中，Excel 文件扮演着至关重要的角色，无论是数据导入、报表生成、还是数据分析，都离不开对 Excel 数据的处理。对于 C# 开发者而言，如何高效、稳定地在应用程序中 C# 读取 Excel 内容，常常是一个需要面对的挑战。传统方法可能需要依赖 Microsoft Office 的 COM 组件，这不仅增加了部署的复杂性，还可能面临兼容性和性能问题。
本文将为您介绍一个强大而专业的 .NET 组件——Spire.XLS for .NET，它能够帮助您摆脱这些困扰，轻松实现 C# 读取 Excel 的需求。我们将详细讲解如何利用 Spire.XLS for .NET 库，以清晰、可操作的步骤和代码示例，读取 Excel 工作表中的全部内容。
1. Spire.XLS for .NET 快速入门
Spire.XLS for .NET 是一款由 E-iceblue 公司开发的专业 Excel 处理组件，它允许开发者在 .NET 应用程序中创建、读取、写入、转换和打印 Excel 文件，而无需安装 Microsoft Office。其主要优势包括：
- 无需 Office 环境： 独立运行，不依赖 Office 软件，简化部署。
- 高性能： 针对大数据量处理进行了优化，读写速度快。
- 功能全面： 支持各种 Excel 特性，如单元格样式、公式、图表、批注等。
- 兼容性强： 支持 .NET Core, .NET Standard, .NET 5+ 以及传统的 .NET Framework。
安装与引用
使用 Spire.XLS for .NET 非常简单，您可以通过 NuGet 包管理器将其添加到您的 C# 项目中。
- 打开 Visual Studio，在您的项目中右键点击“引用”或“依赖项”，选择“管理 NuGet 包”。
- 在“浏览”选项卡中搜索 Spire.XLS。
- 选择 Spire.XLS 包并点击“安装”。
您也可以在 NuGet 包管理器控制台中运行以下命令进行安装：
Install-Package Spire.XLS
安装完成后，您就可以在代码中引用 命名空间，开始您的 Excel 操作 C# 之旅了。
2. 读取整个工作表内容的核心步骤与代码
现在，让我们通过一个具体的代码示例，演示如何使用 Spire.XLS for .NET 读取 Excel 文件中第一个工作表的所有数据。
步骤分解
- 加载 Excel 文件： 使用 Workbook 对象加载目标 Excel 文件。
- 获取工作表： 通过 Workbook.Worksheets 集合获取需要读取的工作表。
- 遍历行和列： 迭代工作表中的行和列，访问每个单元格。
- 获取单元格数据： 提取每个单元格的值。
代码示例
假设我们有一个名为 Sample.xlsx 的 Excel 文件，其中包含一些数据。以下代码将读取该文件的第一个工作表，并将所有单元格的内容打印到控制台。
using System;
using Spire.Xls; // 引入 Spire.Xls 命名空间
namespace ReadExcelDemo
{
class Program
{
static void Main(string[] args)
{
// 1. 创建一个 Workbook 实例并加载 Excel 文件
// 请确保 'Sample.xlsx' 文件存在于应用程序运行目录下，或提供完整路径
Workbook workbook = new Workbook();
workbook.LoadFromFile("Sample.xlsx");
// 2. 获取第一个工作表（索引从0开始）
Worksheet sheet = workbook.Worksheets[0];
Console.WriteLine($"正在读取工作表: {sheet.Name}");
Console.WriteLine("-----------------------------------");
// 3. 遍历工作表中的所有行和列
// sheet.LastRow 和 sheet.LastColumn 获取工作表中包含数据的最后一行和最后一列的索引
for (int row = 1; row <= sheet.LastRow; row++) // 行索引通常从1开始
{
for (int col = 1; col <= sheet.LastColumn; col++) // 列索引通常从1开始
{
// 4. 获取单元格对象并提取其值
// sheet.Range[row, col] 可以获取指定行和列的单元格
CellRange cell = sheet.Range[row, col];
// cell.Value 属性用于获取单元格的原始值，可以根据需要进行类型转换
// cell.Text 属性用于获取单元格的显示文本（格式化后的字符串）
Console.Write($"{cell.Text}\t");
}
Console.WriteLine(); // 每读取完一行，换行
}
Console.WriteLine("-----------------------------------");
Console.WriteLine("Excel 内容读取完毕！");
// 释放资源
workbook.Dispose();
Console.ReadKey();
}
}
}
关键方法/属性解释：
- Workbook: 代表一个 Excel 工作簿文件。
- Workbook.LoadFromFile(string filePath): 用于从指定路径加载 Excel 文件。
- Workbook.Worksheets: 一个集合，包含工作簿中的所有 Worksheet 对象。
- Worksheet: 代表一个 Excel 工作表。
- Worksheet.LastRow: 获取工作表中包含数据的最后一行的索引。
- Worksheet.LastColumn: 获取工作表中包含数据的最后一列的索引。
- Worksheet.Range[int row, int column]: 通过行和列索引获取 CellRange 对象。
- CellRange.Text: 获取单元格格式化后的显示文本。
- CellRange.Value: 获取单元格的原始值，可以是字符串、数字、日期等。
通过以上代码，您已经掌握了 C# 解析 Excel 的基本方法，能够高效地获取 Excel 工作表中的所有数据。
3. 常见读取场景与进阶提示
除了遍历整个工作表，Spire.XLS for .NET 还提供了更灵活的读取方式：
获取特定单元格/区域数据：
- 获取 A1 单元格的值：string value = sheet.Range["A1"].Text;
- 获取 B2 单元格的数值：double number = sheet.Range["B2"].NumberValue;
- 获取特定区域的数据：CellRange range = sheet.Range["A1:C5"]; 然后可以遍历 range 中的单元格。
处理不同数据类型：
- Spire.XLS for .NET 会尝试自动识别单元格的数据类型。您可以使用 CellRange.Value 获取原始值，然后根据需要进行类型转换，或者使用 CellRange.NumberValue、CellRange.DateTimeValue 等属性直接获取特定类型的值。
错误处理建议：
- 在实际应用中，务必添加异常处理机制，例如使用 try-catch 块来捕获文件不存在、文件损坏或权限不足等问题，增强程序的健壮性。
性能优化提示：
- 对于包含数十万行甚至更多数据的大型 Excel 文件，可以考虑分批次读取数据，或者利用 Spire.XLS for .NET 提供的更高级的数据导入导出功能，例如直接将数据导入到 DataTable 中，以提高效率。
总结
本文详细介绍了如何利用强大的 Spire.XLS 库在 C# 应用程序中轻松读取 Excel 内容。从安装配置到核心代码示例，我们展示了其简洁易用的 API 和强大的功能。无论是数据导入、报表处理还是数据分析，Spire.XLS for .NET 都能为您提供高效、稳定的解决方案，帮助您摆脱传统方式的困扰。
以上就是C#使用Spire.XLS读取Excel数据的代码示例的详细内容，更多关于C# Spire.XLS读取Excel数据的资料请关注脚本之家其它相关文章！