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

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

本文将详细讲解如何使用 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 相关产品和应用

全部下载

专题列表