C#使用NPOI将Excel导入导出为DataSet的方法

小满
小满
发布时间:2026-10-16| 6人浏览过
原创

本文将详细讲解如何使用 C# 和 NPOI 库进行 Excel 文件的读取与写入,重点展示将 Excel 数据转换为 DataSet 数据结构的核心逻辑,并附带数据导出功能的实现方法。

NPOI库核心操作

NPOI 是 Apache POI 项目的 .NET 移植版,无需安装 Microsoft Office 即可处理 Office 文档。以下操作主要涉及 System.IO 下的文件流处理与 NPOI 接口交互。

第1步:配置工作环境

首先确保项目中已引入 NPOI.dll 及其依赖库(如 NPOI.OOXML)。代码将针对 .xls(HSSF)和 .xlsx(XSSF)两种常见格式分别实例化对应的 Workbook 对象。

第2步:读取Excel至DataSet

此步骤通过 FileStream 读取指定路径的 Excel 文件,根据后缀区分版本,随后遍历所有 Sheet 页生成 DataTable 并合并入 DataSet。关键细节如下:

  • 版本判断:检测文件后缀,.xlsx 使用 XSSFWorkbook,.xls 使用 HSSFWorkbook。
  • 列头处理:若参数 isFirstLineColumnName 为真,则读取第一行作为列名;否则自动生成默认列名。
  • 单元格映射:
    • 空行或空单元格会被跳过或赋空值。
    • Numeric 类型需特殊处理日期格式(监控 DataFormat 属性),将其转换为 DateCellValue。
/// <summary>
/// 读取Execl数据到DataTable(DataSet)中
/// </summary>
/// <param name="filePath">指定Execl文件路径</param>
/// <param name="isFirstLineColumnName">设置第一行是否是列名</param>
/// <returns>返回一个DataTable数据集</returns>
public static DataSet ExcelToDataSet(string filePath, bool isFirstLineColumnName)
{
    DataSet dataSet = new DataSet();
    int startRow = 0;
    try
    {
        using (FileStream fs = File.OpenRead(filePath))
        {
            IWorkbook workbook = null;
            // 如果是2007+的Excel版本
            if (filePath.IndexOf(".xlsx") > 0)
            {
                workbook = new XSSFWorkbook(fs);
            }
            // 如果是2003-的Excel版本
            else if (filePath.IndexOf(".xls") > 0)
            {
                workbook = new HSSFWorkbook(fs);
            }
            if (workbook != null)
            {
                //循环读取Excel的每个sheet,每个sheet页都转换为一个DataTable,并放在DataSet中
                for (int p = 0; p < workbook.NumberOfSheets; p++)
                {
                    ISheet sheet = workbook.GetSheetAt(p);
                    DataTable dataTable = new DataTable();
                    dataTable.TableName = sheet.SheetName;
                    if (sheet != null)
                    {
                        int rowCount = sheet.LastRowNum;//获取总行数
                        if (rowCount > 0)
                        {
                            IRow firstRow = sheet.GetRow(0);//获取第一行
                            int cellCount = firstRow.LastCellNum;//获取总列数

                            //构建datatable的列
                            if (isFirstLineColumnName)
                            {
                                startRow = 1;//如果第一行是列名,则从第二行开始读取
                                for (int i = firstRow.FirstCellNum; i < cellCount; ++i)
                                {
                                    ICell cell = firstRow.GetCell(i);
                                    if (cell != null)
                                    {
                                        if (cell.StringCellValue != null)
                                        {
                                            DataColumn column = new DataColumn(cell.StringCellValue);
                                            dataTable.Columns.Add(column);
                                        }
                                    }
                                }
                            }
                            else
                            {
                                for (int i = firstRow.FirstCellNum; i < cellCount; ++i)
                                {
                                    DataColumn column = new DataColumn("column" + (i + 1));
                                    dataTable.Columns.Add(column);
                                }
                            }

                            //填充行
                            for (int i = startRow; i <= rowCount; ++i)
                            {
                                IRow row = sheet.GetRow(i);
                                if (row == null) continue;

                                DataRow dataRow = dataTable.NewRow();
                                for (int j = row.FirstCellNum; j < cellCount; ++j)
                                {
                                    ICell cell = row.GetCell(j);
                                    if (cell == null)
                                    {
                                        dataRow[j] = "";
                                    }
                                    else
                                    {
                                        //CellType(Unknown = -1,Numeric = 0,String = 1,Formula = 2,Blank = 3,Boolean = 4,Error = 5,)
                                        switch (cell.CellType)
                                        {
                                            case CellType.Blank:
                                                dataRow[j] = "";
                                                break;
                                            case CellType.Numeric:
                                                short format = cell.CellStyle.DataFormat;
                                                //对时间格式(2015.12.5、2015/12/5、2015-12-5等)的处理
                                                if (format == 14 || format == 22 || format == 31 || format == 57 || format == 58)
                                                    dataRow[j] = cell.DateCellValue;
                                                else
                                                    dataRow[j] = cell.NumericCellValue;
                                                break;
                                            case CellType.String:
                                                dataRow[j] = cell.StringCellValue;
                                                break;
                                        }
                                    }
                                }
                                dataTable.Rows.Add(dataRow);
                            }
                        }
                    }
                    dataSet.Tables.Add(dataTable);
                }

            }
        }
        return dataSet;
    }
    catch (Exception ex)
    {
        var msg = ex.Message;
        return null;
    }
}
相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。