• C#底层库--操作Excel帮助类(读取、导出表格)


    系列文章

    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;
    
    • 1
    • 2
    • 3
    • 4

    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
    {
        /// 
        /// C#底层库--Excel操作帮助类(可读取加密 Excel表格)
        /// 使用过程中发现错误,请联系作者修改 https://blog.csdn.net/youcheng_ge
        /// 
        public class ExcelHelper
        {
            /// 
            /// 读取Excel加密文件(可以读加密文件,性能低)
            /// 
            /// Excel文件路径
            /// 
            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();
                }
            }
    
    
            /// 
            /// 读取Excel非加密文件(仅支持未加密,性能快)
            /// 
            /// 
            /// 
            /// 
            /// 
            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;
                }
    
            }
        }
    }
    
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    • 43
    • 44
    • 45
    • 46
    • 47
    • 48
    • 49
    • 50
    • 51
    • 52
    • 53
    • 54
    • 55
    • 56
    • 57
    • 58
    • 59
    • 60
    • 61
    • 62
    • 63
    • 64
    • 65
    • 66
    • 67
    • 68
    • 69
    • 70
    • 71
    • 72
    • 73
    • 74
    • 75
    • 76
    • 77
    • 78
    • 79
    • 80
    • 81
    • 82
    • 83
    • 84
    • 85
    • 86
    • 87
    • 88
    • 89
    • 90
    • 91
    • 92
    • 93
    • 94
    • 95
    • 96
    • 97
    • 98
    • 99
    • 100
    • 101
    • 102
    • 103
    • 104
    • 105
    • 106
    • 107
    • 108
    • 109
    • 110
    • 111
    • 112
    • 113
    • 114
    • 115
    • 116
    • 117
    • 118
    • 119
    • 120
    • 121
    • 122
    • 123
    • 124
    • 125
    • 126
    • 127
    • 128
    • 129
    • 130
    • 131
    • 132
    • 133
    • 134
    • 135
    • 136
    • 137
    • 138
    • 139
    • 140
    • 141
    • 142
    • 143
    • 144
    • 145
    • 146
    • 147
    • 148
    • 149
    • 150
    • 151
    • 152
    • 153
    • 154
    • 155
    • 156
    • 157
    • 158
    • 159
    • 160
    • 161
    • 162
    • 163
    • 164
    • 165
    • 166
    • 167
    • 168
    • 169
    • 170
    • 171
    • 172
    • 173
    • 174
    • 175
    • 176
    • 177
    • 178
    • 179
    • 180
    • 181
    • 182
    • 183
    • 184
    • 185
    • 186
    • 187
    • 188
    • 189
    • 190
    • 191
    • 192
    • 193
    • 194
    • 195
    • 196
    • 197
    • 198
    • 199
    • 200
    • 201

    三、调用方法

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

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

    四、项目样例

    我是开发了一个小工具,用于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();
           }
       }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14

    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, "转换成功!");
     }
    
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35

    五、资源链接

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

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

  • 相关阅读:
    JavaWeb-cookie&session
    【Webpack5】Webpack学习笔记(一)
    渗透测试面试中常见的问题收集(部分)
    JMeter websocket接口测试
    Aspose.Words for .NET查找和替换教程——如何查找和突出显示文本
    邮件头构造分析
    用于机器学习的 NumPy(ML)
    java基于ssm+vue的考研信息查询系统 elementui
    数组中 forEach 和 Map 的区别
    B端电商-订单逆向流程
  • 原文地址:https://blog.csdn.net/youcheng_ge/article/details/126887445