如何用.NET将Excel数据批量导入到SQL数据库？

在.NET应用程序开发中，将Excel文件中的数据导入到数据库是一项非常常见的需求，例如批量初始化数据、定期同步业务报表等，这个过程涉及读取Excel文件和将数据写入数据库两个核心环节，本文将详细介绍在.NET环境中实现此功能的几种主流方法，并提供实践指导。

核心方法概览

在.NET中处理Excel文件，主要有两大技术路径：一是利用专门的第三方库，它们提供了强大且易于操作的API；二是使用.NET内置的OleDb数据提供程序，将Excel文件模拟为一个数据源进行访问，两种方法各有优劣，适用于不同的场景。

使用第三方库（推荐）

这是目前最主流、最稳定且功能最丰富的方法，第三方库通常对Excel文件格式（.xls和.xlsx）有非常好的支持，并且提供了清晰的面向对象接口来操作工作簿、工作表和单元格。

常用库介绍：

EPPlus: 对.xlsx格式支持极佳，性能优秀，API设计友好，对于.NET Core及后续版本，是其首选之一（注意版本许可）。
NPOI: 一个非常成熟的.NET端口，源于Java的POI项目，它同时支持.xls和.xlsx格式，功能强大，兼容性好，是处理复杂Excel场景的利器。
ClosedXML: 基于OpenXML SDK的封装，API非常简洁直观，易于上手，专注于.xlsx格式。

操作步骤（以NPOI为例）：

安装NuGet包： 在Visual Studio中，通过NuGet包管理器安装NPOI。
读取Excel文件： 使用NPOI的API打开文件，并将目标工作表的数据读取到一个DataTable中，这是一种非常便于后续处理的数据结构。
数据入库： 遍历DataTable中的每一行，构建SQL插入语句或使用参数化查询，将数据逐条插入到目标数据库表中，对于大数据量，推荐使用批量插入技术（如SqlBulkCopy）以提升性能。

核心代码示例（概念性）：

// 1. 加载Excel文件
using (var fs = new FileStream("data.xlsx", FileMode.Open, FileAccess.Read))
{
    var workbook = new XSSFWorkbook(fs);
    var sheet = workbook.GetSheetAt(0);
    // 2. 将数据转换为DataTable
    var dataTable = new DataTable();
    // ... 此处省略将表头添加到DataTable的代码 ...
    for (int rowIndex = 1; rowIndex <= sheet.LastRowNum; rowIndex++)
    {
        var row = sheet.GetRow(rowIndex);
        // ... 读取单元格数据并创建DataRow添加到dataTable ...
    }
    // 3. 将DataTable数据批量插入数据库
    using (var connection = new SqlConnection("Your_Connection_String"))
    {
        connection.Open();
        using (var bulkCopy = new SqlBulkCopy(connection))
        {
            bulkCopy.DestinationTableName = "YourTargetTable";
            bulkCopy.WriteToServer(dataTable);
        }
    }
}

使用OleDb数据提供程序

这是一种较为传统的方法,它不需要任何外部依赖，仅使用.NET Framework本身提供的功能，其原理是通过OleDb驱动程序连接到Excel文件，然后像查询数据库一样执行SQL语句来读取数据。

操作步骤：

构建连接字符串： 连接字符串是此方法的关键，它根据Excel版本和是否包含标题行而有所不同。
- 对于.xlsx (Excel 2007+)：Provider=Microsoft.ACE.OLEDB.12.0;Data Source=filePath;Extended Properties='Excel 12.0 Xml;HDR=YES;'
- 对于.xls (Excel 97-2003)：Provider=Microsoft.Jet.OLEDB.4.0;Data Source=filePath;Extended Properties='Excel 8.0;HDR=YES;'
- HDR=YES表示第一行是列标题，NO则表示第一行即为数据。
执行查询： 使用OleDbConnection和OleDbDataAdapter对象，执行类似SELECT * FROM [Sheet1$]的查询语句，将结果填充到DataSet或DataTable中。
数据入库： 此步骤与方法一相同，将获取到的DataTable数据写入数据库。

注意事项： 此方法对数据类型推断较为敏感，当一列中混合了数字和文本时，可能会出现数据丢失或转换错误（可通过设置IMEX=1参数部分解决，但并非万能），它依赖于系统安装了相应的数据访问组件（如Access Database Engine）。

方法对比与选择

特性维度	使用第三方库 (如NPOI/EPPlus)	使用OleDb
易用性	API清晰，面向对象，易于理解和编程	依赖复杂的连接字符串，SQL语法易出错
稳定性	高，对文件格式兼容性好，错误处理完善	较低，对数据类型敏感，易出现数据读取问题
性能	优秀，特别是针对.xlsx格式的库	一般，对于大文件性能较差
功能丰富度	非常高，可读写、设置样式、图表等	仅支持基本的数据读取
依赖性	需要通过NuGet引入外部DLL	依赖系统安装的数据驱动组件

除非有特殊限制（如严格禁止外部依赖），否则强烈推荐使用第三方库来完成Excel导入任务。

关键注意事项与最佳实践

数据类型处理： 在读取数据后，务必进行数据验证和类型转换，检查日期格式是否正确，数字是否为空等，避免插入数据库时因类型不匹配而失败。
性能优化： 对于超过数千行的大数据量，应避免使用循环单条INSERT语句，应优先采用SqlBulkCopy（SQL Server）、BulkLoader（MySQL）等数据库提供的批量加载机制，性能可提升数十倍。
错误处理与日志： 导入过程应包裹在try-catch块中，对于失败的行，记录详细的错误信息（如行号、错误原因）到日志文件，而不是让整个程序崩溃，以便用户修正数据后重新导入。
文件格式兼容性： 在开发前明确需要支持的Excel格式（.xls或.xlsx），并选择合适的库，NPOI是同时支持两者的通用选择。