在企业级 .NET 开发场景中,Excel 文件与内存数据集(如 DataTable)的格式互转是高频技术需求。DataTable 作为 .NET 框架中通用的内存数据结构,常被用于承接 Excel 数据并完成后续的数据验证、持久化、展示等操作。本文聚焦于 .NET 环境下,如何通过第三方类库实现 Excel 文件到 DataTable 的高效转换,核心讲解数据转换的技术实现逻辑与关键方法的使用。

在开始前可通过NuGet包管理器快速安装 Free Spire.XLS for .NET 免费库,具体步骤如下:

  1. 右键项目 → 管理 NuGet 程序包;
  2. 搜索对应类库名称并安装最新稳定版;
  3. 或在 Package Manager Console 执行命令:
Install-Package FreeSpire.XLS

注意:该类库的免费版本存在数据量使用限制,适用于小规模数据处理场景。


核心实现:Excel 转 DataTable

1. 基础实现:完整转换流程

以下代码实现 Excel 文件到 DataTable 的核心转换逻辑,覆盖 “加载 Excel 文件 → 选取目标工作表 → 调用封装方法完成数据转换 → 验证转换结果” 全流程,可直接用于基础转换场景:

using Spire.Xls;
using System;
using System.Data;

namespace ExcelToDataTableDemo
{
    class Program
    {
        static void Main()
        {
            // 定义Excel文件路径
            string excelFilePath = "Sample.xlsx";

            // 1. 初始化Workbook并加载Excel文件
            Workbook workbook = new Workbook();
            workbook.LoadFromFile(excelFilePath);

            // 2. 获取第一个工作表(索引从0开始)
            Worksheet sheet = workbook.Worksheets[0];

            // 3. 核心:调用内置ExportDataTable方法转换
            // 参数1:要导出的单元格范围(AllocatedRange表示工作表的有效数据范围)
            // 参数2:是否将第一行作为DataTable的列名
            DataTable dataTable = sheet.ExportDataTable(sheet.AllocatedRange, true);

            // 4. 验证转换结果:输出数据信息
            Console.WriteLine("=== Excel转DataTable结果 ===");
            // 输出总行数(排除表头)
            Console.WriteLine($"数据总行数:{dataTable.Rows.Count}");
            // 输出列名
            Console.Write("列名:");
            foreach (DataColumn col in dataTable.Columns)
            {
                Console.Write(col.ColumnName + "\t");
            }
            Console.WriteLine("\n=== 数据内容 ===");
            // 输出所有行数据
            foreach (DataRow row in dataTable.Rows)
            {
                foreach (var cellValue in row.ItemArray)
                {
                    Console.Write(cellValue + "\t");
                }
                Console.WriteLine();
            }
        }
    }
}

2. 进阶用法:自定义转换范围与参数

ExportDataTable 提供多个重载方法,可满足“指定转换范围、是否导出计算公式值”等个性化开发需求,以下是两类典型的进阶使用场景:

场景1:指定行/列范围转换(如第2-10行、第1-3列)

// 获取指定范围的单元格(行/列索引均从1开始)
CellRange targetRange = sheet.Range["A2:C10"];
// 转换指定范围,且不将第一行作为列名(因范围从第2行开始)
DataTable dataTable = sheet.ExportDataTable(targetRange, false);

场景2:转换时计算公式值

// 重载方法:第三个参数控制是否计算公式值。
// 参数说明:
// range:转换范围
// exportColumnNames:是否将第一行作为列名
// computedFormulaValue:是否计算公式值
DataTable dataTable = sheet.ExportDataTable(
    sheet.AllocatedRange, 
    true,  
    true
);

在.NET开发中,通过 ExportDataTable 方法可实现 Excel 数据到 DataTable 的批量转换,该方法通过封装底层的单元格遍历、数据类型映射逻辑,替代了手动逐单元格读取数据的方式,是 Excel 与 DataTable 互转场景下的高效实现方案。