C#底层库--Excel数据读取类（可读加密表格）

花北城

已于 2023-05-19 18:39:47 修改

阅读量3.8k

点赞数 4

分类专栏：底层库（Helper、Builder、Tools）文章标签： c# 表格导入 Excel 读取Excel

于 2022-09-16 11:46:04 首次发布

本文链接：https://blog.csdn.net/youcheng_ge/article/details/126887445

版权

底层库（Helper、Builder、Tools）专栏收录该内容

21 篇文章 18 订阅

订阅专栏

系列文章

C#底层库–记录日志帮助类
本文链接：https://blog.csdn.net/youcheng_ge/article/details/124187709

C#底层库–MySQL脚本自动构建类（insert、update语句生成）
本文链接：https://blog.csdn.net/youcheng_ge/article/details/129179216

C#底层库–MySQL数据库访问操作辅助类（推荐阅读）
本文链接：https://blog.csdn.net/youcheng_ge/article/details/126886379

C#底层库–XML配置参数读写辅助类（推荐阅读）
本文链接：https://blog.csdn.net/youcheng_ge/article/details/129175304

C#底层库–获取文件版本和MD5值
本文链接：https://blog.csdn.net/youcheng_ge/article/details/112513871

C#底层库–操作文件帮助类FileHelper（获取目录的所有文件）
本文链接：https://blog.csdn.net/youcheng_ge/article/details/126887161

C#底层库–操作Excel帮助类（读取、导出表格）
本文链接：https://blog.csdn.net/youcheng_ge/article/details/126887445

C#底层库–随机数生成类
本文链接：https://blog.csdn.net/youcheng_ge/article/details/126888812

C#底层库–正则表达式帮助类
本文链接：https://blog.csdn.net/youcheng_ge/article/details/109745286

C#底层库–CSV和DataTable相互转换
本文链接：https://blog.csdn.net/youcheng_ge/article/details/128804367

C#底层库–Image图片操作类
本文链接：https://blog.csdn.net/youcheng_ge/article/details/128805298

C#底层库–JSON帮助类_详细（序列化、反序列化、list、datatable）
本文链接：https://blog.csdn.net/youcheng_ge/article/details/128805705

C#底层库–cookie操作辅助类
本文链接：https://blog.csdn.net/youcheng_ge/article/details/128816347

C#底层库–Session操作辅助类
本文链接：https://blog.csdn.net/youcheng_ge/article/details/128817096

C#底层库–数据实体类
本文链接：https://blog.csdn.net/youcheng_ge/article/details/128816638

C#底层库–Image图片操作类
本文链接：https://blog.csdn.net/youcheng_ge/article/details/128805298

C#底层库–数据库类型与程序类型转换类
本文链接：https://blog.csdn.net/youcheng_ge/article/details/128817610

C#底层库–日期扩展类（上周、本周、明年、前年等）
本文链接：https://blog.csdn.net/youcheng_ge/article/details/129040663

前言

本专栏为【底层库】，主要介绍编程过程中通用函数。我们将这些通用固化的源码，进行重写、封装、拓展，再进行单元测试、集成测试、beta测试，最终形成通用化模板，这里我们称为“底层库”。

作为研发人员的你，并不需要花大量时间，研究“底层库”的含义，及“底层库”的实现方法。你只需要几行调用代码，就可以解决项目上碰到的难题。而底层库使用方法，本专栏均有详细介绍，也有项目应用场景。

底层库已实现功能：MySQL脚本构建器、MySQL数据库访问操作、参数配置文件读写、加解密算法、日志记录、HTTP通信、Socket通信、API前后端交互、邮件发送、文件操作、配置参数存储、Excel导入导出、CSV和DataTable转换、压缩解压、自动编号、Session操作等。

本专栏会持续更新，不断优化【底层库】，大家有任何问题，可以私信我。本专栏之间关联性较强（我会使用到某些底层库，某些文章可能忽略介绍），如果您对本专栏感兴趣，欢迎关注，我将带你用最简洁的代码，实现最复杂的功能。

在这里插入图片描述

一、底层库作用

Excel操作帮助类，解决方法是读取Excel表格数据转换成通用的DataTable，方便开发人员进行处理。
通俗的说，使用本底层库，你将无需知道“Excel读取是如何实现的？”、“Excel版本问题（.xls、.xlsx）？”、“Excel加密了怎么办？”等一系列复杂问题。
可以参照【三、调用方法】章节的案列，模仿着写一下调用代码，你将获得一个DataTable，你可以对DataTable进行foreach遍历；可以对DataTable进行硬存储即数据库存储（需结合本专栏SQL构造库使用）；可以做通用选择、下拉选择等。

关于读取Excel有三种方式：
①微软提供的组件Microsoft.Office.Interop.Excel读取。
②采用NPOI组件读取，这是广大网友采用的方式，但是有局限性
③采用select查询方式，限制太多，已经过时，本文不采用不做介绍。
提示：两种方式均可以，其中方法①资源占用大、速度慢；方法②资源占用小、速度快。那我为何仍旧给出方法①呢？是因为如果是保密单位，公司电脑上安装有加密软件的，会对文档进行加密，方法②读取Excel表格会失败。而由于方法①采用office自带的开放式组件，是能够正常读取文档的，前提是你正确安装了office、WPS，并且安装时勾选了“开放可编程组件”，如果其实就是需要组件支持。

小白可能无法理解，保密单位为啥Excel文档要加密呢？刚我公司为保密单位，我这里有个现成的案例。
在这里插入图片描述
仔细看“红色方框”的Excel，图标上有一个小锁标记，表明此文件是加密的，你只有在公司内网环境下可以正常打开，你拿到外网或者你自己的设备上是打不开文件的，打开只是一堆乱码。
但是问题来了，我们开发的软件要适用任何环境，就是即使拿到外网环境，我也要能够读取Excel的内容，这就是我们方法①的区别。

二、底层库源码

2.1 引用组件

项目中，你需要提前引用组件 NPOI.dll、NPOI.OOXML.dll、NPOI.OpenXml4Net.dll、NPOI.OpenXmlFormats.dll。这些动态链接库，你可以去网上自行下载，也可以在本文《五、资源链接》中找到它。

命令空间，复制如下代码：

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;
using NPOI.HSSF.UserModel;
using Microsoft.Office.Interop.Excel;

2.2 创建类ExcelHelper

我们将Excel表格转换为DataTable，方便程序操作。创建类ExcelHelper.cs，复制以下代码：

using System;
using System.IO;
using System.Data;
using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;
using NPOI.HSSF.UserModel;
using Microsoft.Office.Interop.Excel;

namespace ExcelImportTool
{
    /// <summary>
    /// C#底层库--Excel操作帮助类（可读取加密 Excel表格）
    /// 使用过程中发现错误，请联系作者修改 https://blog.csdn.net/youcheng_ge
    /// </summary>
    public class ExcelHelper
    {
        /// <summary>
        /// 读取Excel加密文件（可以读加密文件，性能低）
        /// </summary>
        /// <param name="excelFilePath">Excel文件路径</param>
        /// <returns></returns>
        public System.Data.DataTable ExcelToDataTableWhithEncryp(string excelFilePath)
        {
            Application app = new Application();
            Sheets sheets;
            Workbook workbook = null;
            object oMissiong = System.Reflection.Missing.Value;
            System.Data.DataTable dt = new System.Data.DataTable();

            try
            {
                //只读、密码、样式、提示等参数，我们用不着，默认全部空
                workbook = app.Workbooks.Open(excelFilePath, oMissiong, oMissiong, oMissiong, oMissiong, oMissiong, oMissiong, oMissiong, oMissiong, oMissiong, oMissiong, oMissiong, oMissiong, oMissiong, oMissiong);

                //获取Excel表格的 Worksheets
                sheets = workbook.Worksheets;
                Worksheet worksheet = (Worksheet)sheets.get_Item(1);//读取第一sheets
                if (worksheet == null)
                    return null;

                string cellContent;
                //最大列数（底层有bug，部分Excel由于导出、拷贝因素，会出现空白行。也将空白行算进去了。）
                int iRowCount = worksheet.UsedRange.Rows.Count;
                //最大列数
                int iColCount = worksheet.UsedRange.Columns.Count; 
                Range range;

                //负责列头Start
                DataColumn dc;
                //列序号
                int ColumnID = 1;
                range = (Range)worksheet.Cells[1, 1];
                while (!string.IsNullOrEmpty(range.Text.ToString().Trim()))
                {
                    dc = new DataColumn();
                    dc.DataType = System.Type.GetType("System.String");
                    dc.ColumnName = range.Text.ToString().Trim();
                    dt.Columns.Add(dc);

                    range = (Range)worksheet.Cells[1, ++ColumnID];
                }


                //有效数据列，解决空白列问题。
                iColCount = ColumnID-1;

                for (int iRow = 2; iRow <= iRowCount; iRow++) //行循环
                {
                    DataRow dr = dt.NewRow();
                    string str_RowData = "";//行数据
                    for (int iCol = 1; iCol <= iColCount; iCol++) //列循环
                    {
                        range = (Range)worksheet.Cells[iRow, iCol];
                        cellContent = (range.Value2 == null) ? "" : range.Text.ToString();
                        str_RowData += cellContent;
                        dr[iCol - 1] = cellContent;
                    }

                    //有效数据行，解决空白行问题。
                    if (string.IsNullOrEmpty(str_RowData.Trim())) 
                    {
                        break;
                    }
                    dt.Rows.Add(dr);
                }

                return dt;
            }
            catch(Exception ex)
            {
                Console.WriteLine("异常: " + ex.Message);
                return null;
            }
            finally
            {
                workbook.Close(false, oMissiong, oMissiong);
                System.Runtime.InteropServices.Marshal.ReleaseComObject(workbook);
                workbook = null;
                app.Workbooks.Close();
                app.Quit();
                System.Runtime.InteropServices.Marshal.ReleaseComObject(app);
                app = null;
                GC.Collect();
                GC.WaitForPendingFinalizers();
            }
        }


        /// <summary>
        /// 读取Excel非加密文件（仅支持未加密，性能快）
        /// </summary>
        /// <param name="fileName"></param>
        /// <param name="sheetName"></param>
        /// <param name="isFirstRowColumn"></param>
        /// <returns></returns>
        public System.Data.DataTable ExcelToDataTable(string fileName, string sheetName = null, bool isFirstRowColumn = true)
        {
            FileStream fs = null;
            ISheet sheet = null;
            System.Data.DataTable data = new System.Data.DataTable();
            IWorkbook workbook = null;
            int startRow = 1;
            try
            {
                fs = new FileStream(fileName, FileMode.Open, FileAccess.Read);
                if (fileName.IndexOf(".xlsx") > 0) // 2007版本
                    workbook = new XSSFWorkbook(fs);
                else if (fileName.IndexOf(".xls") > 0) // 2003版本
                    workbook = new HSSFWorkbook(fs);

                if (sheetName != null)
                {
                    sheet = workbook.GetSheet(sheetName);
                    if (sheet == null) //如果没有找到指定的sheetName对应的sheet，则尝试获取第一个sheet
                    {
                        sheet = workbook.GetSheetAt(0);
                    }
                }
                else
                {
                    sheet = workbook.GetSheetAt(0);
                }
                if (sheet != null)
                {
                    IRow firstRow = sheet.GetRow(0);//读取标题
                    int cellCount = firstRow.LastCellNum; //一行最后一个cell的编号 即总的列数

                    if (isFirstRowColumn)
                    {
                        for (int i = firstRow.FirstCellNum; i < cellCount; ++i)
                        {
                            NPOI.SS.UserModel.ICell cell = firstRow.GetCell(i);

                            if (cell != null)
                            {
                                string cellValue = cell.StringCellValue;
                                if (cellValue != null)
                                {
                                    DataColumn column = new DataColumn(cellValue);
                                    data.Columns.Add(column);
                                }
                            }
                        }
                        startRow = sheet.FirstRowNum + 1;
                    }
                    else
                    {
                        startRow = sheet.FirstRowNum;
                    }

                    //最后一列的标号
                    int rowCount = sheet.LastRowNum;
                    for (int i = startRow; i <= rowCount; ++i)
                    {
                        IRow row = sheet.GetRow(i);
                        if (row == null) continue; //没有数据的行默认是null　　　　　　　

                        DataRow dataRow = data.NewRow();
                        for (int j = row.FirstCellNum; j < cellCount; ++j)
                        {
                            if (row.GetCell(j) != null) //同理，没有数据的单元格都默认是null
                            {
                                dataRow[j] = row.GetCell(j).ToString();
                            }

                        }
                        data.Rows.Add(dataRow);
                    }
                }
                return data;
            }
            catch (Exception ex)
            {
                Console.WriteLine("异常: " + ex.Message);
                return null;
            }

        }
    }
}

三、调用方法

实例化ExcelHelper对象，通过ExcelToDataTableWhithEncryp(参数1)直接读取成DataTable表格。
参数1：Excel文件的绝对路径。

	ExcelHelper excelHelper = new ExcelHelper();
	DataTable l_dtTemp = excelHelper.ExcelToDataTableWhithEncryp(this.text_ExcelDir.Text);

四、项目样例

我是开发了一个小工具，用于ERP系统基础数据的初始化工作，比如：员工档案、仓库货位信息、存货档案的数据导入等。

4.1 软件界面

软件界面如下：
在这里插入图片描述

4.2 选择文件

选择Excel文件位置。

在这里插入图片描述

4.3 打开文件按钮事件

   //选择路径
   private void BTN_Select_Click(object sender, EventArgs e)
   {
       OpenFileDialog dialog = new OpenFileDialog();
       dialog.Title = "请选择文件";
       dialog.Filter = "Excel 工作簿|*.xlsx|Excel 97-2003 工作簿|*.xls|所有文件(*.*)|*.*";
       dialog.FileName = AppDomain.CurrentDomain.BaseDirectory;

       if (dialog.ShowDialog() == System.Windows.Forms.DialogResult.OK)
       {
           this.text_ExcelDir.Text = dialog.FileName;
           ConvertSQL();
       }
   }

4.4 转换SQL方法

 //转换SQL
 private void ConvertSQL()
 {
     this.richTextBox1.Clear();
     string l_strFileName = Path.GetFileNameWithoutExtension(this.text_ExcelDir.Text);

     ExcelHelper excelHelper = new ExcelHelper();
     DataTable dt_Temp = excelHelper.ExcelToDataTableWhithEncryp(this.text_ExcelDir.Text);
     if (dt_Temp == null || dt_Temp.Rows.Count==0)
     {
         FrmTips.ShowTipsError(this, "表格读取为空！");
         return;
     }

     //每批数量
     decimal dec_num = 100;
     decimal.TryParse(AppConfig.GetValue("batch_num"), out dec_num);

     //是否开启
     bool b_Open = false;
     bool.TryParse(AppConfig.GetValue("open_tag"), out b_Open);

     if (b_Open)
     {
         int int_num = Convert.ToInt32(Math.Truncate(dec_num));
         richTextBox1.AppendText(CodeFactory.CreateInsertSQLBatch(dt_Temp, l_strFileName, int_num));
     }
     else
     {
         richTextBox1.AppendText(CodeFactory.CreateInsertSQL(dt_Temp, l_strFileName));
     }

     FrmTips.ShowTipsSuccess(this, "转换成功！");
 }

五、资源链接

我这里提供一个Excel数据导入工具，采用以上底层库开发，可用于【基础数据初始化】
在这里插入图片描述

链接：https://pan.baidu.com/s/1xW7tZcmZ_PeseAT0ukzbIA?pwd=1dua
提取码：1dua

花北城

关注

4
点赞
踩
39

收藏

觉得还不错? 一键收藏
打赏
0
评论
C#底层库--Excel数据读取类（可读加密表格）

Excel操作帮助类，解决方法是读取Excel表格数据转换成通用的DataTable，方便开发人员进行处理。通俗的说，使用本底层库，你将无需知道“Excel读取是如何实现的？”、“Excel版本问题（*.xls、*.xlsx）？”、“Excel加密了怎么办？”等一系列复杂问题。可以参照【三、调用方法】章节的案列，模仿着写一下调用代码，你将获得一个DataTable，你可以对DataTable进行foreach遍历；可以对DataTable进行硬存储即数据库存储（需结合本专栏SQL构造库使用）；可以做通用
复制链接

扫一扫