.NET Core使用NPOI导出复杂，美观的Excel详解

时间  2020-12-03
标签 html 前端 git github 工具 布局 学习 字体 spa 设计 栏目 Java开源 繁體版
原文   原文链接

前言：

　　这段时间一直专一于数据报表的开发，固然涉及到相关报表的开发数据导出确定是一个不可避免的问题啦。客户要求要导出优雅，美观的Excel文档格式的来展现数据，当时的第一想法就是使用NPOI开源库来作数据导出Excel文档（当时想一想真香，网上随便搜一搜教程一大堆），可是当本身真正的实践起来才知道原来想要给不一样的单元格设置相关的字体样式、边框样式以及单元格样式一个简单的样式须要写这么多行代码来实现。做为一个喜欢编写简洁代码的我而言确定是受不了的，因而乎提起袖子说干就干，我本身根据网上的一些资料本身封装了一个通用的NPOI导出Excel帮助类，主要包括行列建立，行内单元格经常使用样式封装（如：字体样式，字体颜色，字体大小，单元格背景颜色，单元格边框，单元格内容对齐方式等经常使用属性），但愿在之后的开发中可以使用到，而且也但愿可以帮助到更多有须要的同窗。html

1、引入NPOI NuGet：

NPOI GitHub源码地址：

https://github.com/tonyqus/npoi前端

版本说明：

　　NPOI 2.4.1 （注意不一样版本可能使用的姿式有点小差异）git

程序包管理器控制台输入一下命令安装：

Install-Package NPOI -Version 2.4.1

经过NuGet管理解决方案安装：

选择=>工具=>NuGet包管理器=>程序包管理器控制台：

 搜索：NPOI进行安装：

 2、导出Excel文档内容展现格式以下如所示：

 3、CellStyle单元格经常使用样式概述：

HSSFCellStyle cellStyle = (HSSFCellStyle)workbook.CreateCellStyle(); //建立列头单元格实例样式
cellStyle.Alignment = hAlignment; //水平布局方式（HorizontalAlignment hAlignment）
cellStyle.VerticalAlignment = vAlignment; //垂直布局方式（VerticalAlignment vAlignment）
cellStyle.WrapText =false;//是否自动换行

//TODO:十分注意，要设置单元格背景色必须是FillForegroundColor和FillPattern两个属性同时设置，不然是不会显示背景颜色
//以下设置黄色背景色
cellStyle.FillForegroundColor = cellBackgroundColor;//单元格背景颜色（short cellBackgroundColor = HSSFColor.Yellow.Index）
cellStyle.FillPattern = fillPattern;//填充图案样式(FineDots 细点，SolidForeground立体前景，isAddFillPattern=true时存在（FillPattern fillPattern = FillPattern.SolidForeground）

//设置单元格边框样式
//经常使用的边框样式 None(没有),Thin(细边框，瘦的),Medium(中等),Dashed(虚线),Dotted(星罗棋布的),Thick(厚的),Double(双倍),Hair(头发)[上右下左顺序设置]
cellStyle.BorderBottom = BorderStyle.Thin;
cellStyle.BorderRight = BorderStyle.Thin;
cellStyle.BorderTop = BorderStyle.Thin;
cellStyle.BorderLeft = BorderStyle.Thin;

//设置单元格边框颜色[上右下左顺序设置]
cellStyle.TopBorderColor = HSSFColor.DarkGreen.Index;//DarkGreen(黑绿色)
cellStyle.RightBorderColor = HSSFColor.DarkGreen.Index;
cellStyle.BottomBorderColor = HSSFColor.DarkGreen.Index;
cellStyle.LeftBorderColor = HSSFColor.DarkGreen.Index;

4、Font字体经常使用属性概述：

var cellStyleFont = (HSSFFont)workbook.CreateFont();//建立字体对象实例
//假如字体大小只须要是粗体的话直接使用下面该属性便可
cellStyleFont.IsBold = true;

//或者经过下面属性，设置字体weight来设置字体是否加粗
cellStyleFont.Boldweight = boldWeight; //字体加粗（字体加粗 (None = 0,Normal = 400，Bold = 700）
cellStyleFont.FontHeightInPoints = fontHeightInPoints; //字体大小（short fontHeightInPoints）
cellStyleFont.FontName = fontName;//字体（仿宋，楷体，宋体 ）
cellStyleFont.Color = fontColor;//设置字体颜色（short fontColor = HSSFColor.Black.Index）
cellStyleFont.IsItalic =true;//是否将文字变为斜体（true是，false否）
cellStyleFont.Underline = underlineStyle;//字体下划线（下划线样式（无下划线[None],单下划线[Single],双下划线[Double],会计用单下划线[SingleAccounting],会计用双下划线[DoubleAccounting]））
cellStyleFont.TypeOffset = typeOffset;//字体上标下标（字体上标下标(普通默认值[None],上标[Sub],下标[Super]),即字体在单元格内的上下偏移量）
cellStyleFont.IsStrikeout =true;//是否显示删除线（true显示，false不显示）

5、NPOI HSSFColor 颜色索引对照表:

说明：经过对相关属性的介绍，咱们能够清楚的知道不管是字体颜色，表格边框颜色，仍是单元格背景颜色咱们都须要用到HSSFColor对象中的颜色属性索引（该索引的字符类型为short类型）。github

HSSFColor颜色索引对照表以下表所示：

表格来源：http://www.javashuo.com/article/p-ffispxul-me.html  （潘小博1992）工具

颜色 Class名称(注意因为NPOI的版本缘由，咱们在使用对应Class名称时首字母可能须要小写) short
　 Black 8
　 Brown 60
　 Olive_Green 59
　 Dark_Green 58
　 Dark_Teal 56
　 Dark_Blue 18
　 Indigo 62
　 Grey_80_PERCENT 63
　 Dark_Red 16
　 Orange 53
　 DARK_YELLOW 19
　 Green 17
　 Teal 21
　 Blue 12
　 Blue_Grey 54
　 Grey_50_PERCENT 23
　 Red 10
　 LIGHT_ORANGE 52
　 LIME 50
　 SEA_GREEN 57
　 AQUA 49
　 LIGHT_BLUE 48
　 VIOLET 20
　 GREY_40_PERCENT 55
　 Pink 14
　 Gold 51
　 Yellow 13
　 BRIGHT_GREEN 11
　 TURQUOISE 15
　 SKY_BLUE 40
　 Plum 61
　 GREY_25_PERCENT 22
　 Rose 45
　 Tan 47
　 LIGHT_YELLOW 43
　 LIGHT_GREEN 42
　 LIGHT_TURQUOISE 41
　 PALE_BLUE 44
　 LAVENDER 46
　 White 9
　 CORNFLOWER_BLUE 24
　 LEMON_CHIFFON 26
　 MAROON 25
　 ORCHID 28
　 CORAL 29
　 ROYAL_BLUE 30
　 LIGHT_CORNFLOWER_BLUE 31
　 AUTOMATIC 64

 6、关于NPOI对Excel中的行列经常使用操做方法概述：

建立Excel工做表，给工做表赋一个名称(Excel底部名称)：

var sheet = workbook.CreateSheet("人才培训课程表");

 建立Excel中指定的行:

/// <summary>
        /// TODO:先建立行，而后在建立对应的列
        /// 建立Excel中指定的行
        /// </summary>
        /// <param name="sheet">Excel工做表对象</param>
        /// <param name="rowNum">建立第几行(从0开始)</param>
        /// <param name="rowHeight">行高</param>
        public HSSFRow CreateRow(ISheet sheet, int rowNum, float rowHeight)
        {
            HSSFRow row = (HSSFRow)sheet.CreateRow(rowNum); //建立行
            row.HeightInPoints = rowHeight; //设置列头行高
            return row;
        }

建立行内指定的单元格:

/// <summary>
        /// 建立行内指定的单元格
        /// </summary>
        /// <param name="row">须要建立单元格的行</param>
        /// <param name="cellStyle">单元格样式</param>
        /// <param name="cellNum">建立第几个单元格(从0开始)</param>
        /// <param name="cellValue">给单元格赋值</param>
        /// <returns></returns>
        public HSSFCell CreateCells(HSSFRow row, HSSFCellStyle cellStyle, int cellNum, string cellValue)
        {
            HSSFCell cell = (HSSFCell)row.CreateCell(cellNum); //建立单元格
            cell.CellStyle = cellStyle; //将样式绑定到单元格
            if (!string.IsNullOrWhiteSpace(cellValue))
            {
                //单元格赋值
                cell.SetCellValue(cellValue);
            }

            return cell;
        }

指定合并的行列:　　

//TODO:关于Excel行列单元格合并问题(注意：合并单元格后，只需对第一个位置赋值便可)
                /**
                  第一个参数：从第几行开始合并
                  第二个参数：到第几行结束合并
                  第三个参数：从第几列开始合并
                  第四个参数：到第几列结束合并
                **/
                CellRangeAddress region = new CellRangeAddress(0, 0, 0, 5);
                sheet.AddMergedRegion(region);

                cell.SetCellValue("人才培训课程表");//TODO:顶部标题

设置单元格的列宽：

sheet.SetColumnWidth(单元格索引,1000);//设置对应列宽（单元格索引从0开始，后面接宽度）　　

7、NPOI生成Excel文档完整代码：

NPOI之Excel数据导出帮助类（建立Excel表格行列，设置行高，设置字体样式，单元格边框样式，单元格背景颜色和样式，单元格内容对齐方式等经常使用属性和样式封装）:

/** * Author:追逐时光 * Description：Npoi之Excel数据导出帮助类（建立Excel表格行列，设置行高，设置字体样式，单元格边框样式，单元格背景颜色和样式，单元格内容对齐方式等经常使用属性和样式封装） * Description：2020年3月29日 */
using NPOI.HSSF.UserModel; using NPOI.SS.UserModel; using NPOI.HSSF.Util; namespace YY_Utility { public class NpoiExcelExportHelper { private static NpoiExcelExportHelper _exportHelper; public static NpoiExcelExportHelper _ { get => _exportHelper ?? (_exportHelper = new NpoiExcelExportHelper()); set => _exportHelper = value; } /// <summary>
        /// TODO:先建立行，而后在建立对应的列 /// 建立Excel中指定的行 /// </summary>
        /// <param name="sheet">Excel工做表对象</param>
        /// <param name="rowNum">建立第几行(从0开始)</param>
        /// <param name="rowHeight">行高</param>
        public HSSFRow CreateRow(ISheet sheet, int rowNum, float rowHeight) { HSSFRow row = (HSSFRow)sheet.CreateRow(rowNum); //建立行
            row.HeightInPoints = rowHeight; //设置列头行高
            return row; } /// <summary>
        /// 建立行内指定的单元格 /// </summary>
        /// <param name="row">须要建立单元格的行</param>
        /// <param name="cellStyle">单元格样式</param>
        /// <param name="cellNum">建立第几个单元格(从0开始)</param>
        /// <param name="cellValue">给单元格赋值</param>
        /// <returns></returns>
        public HSSFCell CreateCells(HSSFRow row, HSSFCellStyle cellStyle, int cellNum, string cellValue) { HSSFCell cell = (HSSFCell)row.CreateCell(cellNum); //建立单元格
            cell.CellStyle = cellStyle; //将样式绑定到单元格
            if (!string.IsNullOrWhiteSpace(cellValue)) { //单元格赋值
 cell.SetCellValue(cellValue); } return cell; } /// <summary>
        /// 行内单元格经常使用样式设置 /// </summary>
        /// <param name="workbook">Excel文件对象</param>
        /// <param name="hAlignment">水平布局方式</param>
        /// <param name="vAlignment">垂直布局方式</param>
        /// <param name="fontHeightInPoints">字体大小</param>
        /// <param name="isAddBorder">是否须要边框</param>
        /// <param name="boldWeight">字体加粗 (None = 0,Normal = 400，Bold = 700</param>
        /// <param name="fontName">字体（仿宋，楷体，宋体，微软雅黑...与Excel主题字体相对应）</param>
        /// <param name="isAddBorderColor">是否增长边框颜色</param>
        /// <param name="isItalic">是否将文字变为斜体</param>
        /// <param name="isLineFeed">是否自动换行</param>
        /// <param name="isAddCellBackground">是否增长单元格背景颜色</param>
        /// <param name="fillPattern">填充图案样式(FineDots 细点，SolidForeground立体前景，isAddFillPattern=true时存在)</param>
        /// <param name="cellBackgroundColor">单元格背景颜色（当isAddCellBackground=true时存在）</param>
        /// <param name="fontColor">字体颜色</param>
        /// <param name="underlineStyle">下划线样式（无下划线[None],单下划线[Single],双下划线[Double],会计用单下划线[SingleAccounting],会计用双下划线[DoubleAccounting]）</param>
        /// <param name="typeOffset">字体上标下标(普通默认值[None],上标[Sub],下标[Super]),即字体在单元格内的上下偏移量</param>
        /// <param name="isStrikeout">是否显示删除线</param>
        /// <returns></returns>
        public HSSFCellStyle CreateStyle(HSSFWorkbook workbook, HorizontalAlignment hAlignment, VerticalAlignment vAlignment, short fontHeightInPoints, bool isAddBorder, short boldWeight, string fontName = "宋体", bool isAddBorderColor = true, bool isItalic = false, bool isLineFeed = false, bool isAddCellBackground = false, FillPattern fillPattern = FillPattern.NoFill, short cellBackgroundColor = HSSFColor.Yellow.Index, short fontColor = HSSFColor.Black.Index, FontUnderlineType underlineStyle = FontUnderlineType.None, FontSuperScript typeOffset = FontSuperScript.None, bool isStrikeout = false) { HSSFCellStyle cellStyle = (HSSFCellStyle)workbook.CreateCellStyle(); //建立列头单元格实例样式
            cellStyle.Alignment = hAlignment; //水平居中
            cellStyle.VerticalAlignment = vAlignment; //垂直居中
            cellStyle.WrapText = isLineFeed;//自动换行 //背景颜色，边框颜色，字体颜色都是使用 HSSFColor属性中的对应调色板索引，关于 HSSFColor 颜色索引对照表，详情参考：https://www.cnblogs.com/Brainpan/p/5804167.html

            //TODO：引用了NPOI后可经过ICellStyle 接口的 FillForegroundColor 属性实现 Excel 单元格的背景色设置，FillPattern 为单元格背景色的填充样式 //TODO:十分注意，要设置单元格背景色必须是FillForegroundColor和FillPattern两个属性同时设置，不然是不会显示背景颜色
            if (isAddCellBackground) { cellStyle.FillForegroundColor = cellBackgroundColor;//单元格背景颜色
                cellStyle.FillPattern = fillPattern;//填充图案样式(FineDots 细点，SolidForeground立体前景)
 } //是否增长边框
            if (isAddBorder) { //经常使用的边框样式 None(没有),Thin(细边框，瘦的),Medium(中等),Dashed(虚线),Dotted(星罗棋布的),Thick(厚的),Double(双倍),Hair(头发)[上右下左顺序设置]
                cellStyle.BorderBottom = BorderStyle.Thin; cellStyle.BorderRight = BorderStyle.Thin; cellStyle.BorderTop = BorderStyle.Thin; cellStyle.BorderLeft = BorderStyle.Thin; } //是否设置边框颜色
            if (isAddBorderColor) { //边框颜色[上右下左顺序设置]
                cellStyle.TopBorderColor = HSSFColor.DarkGreen.Index;//DarkGreen(黑绿色)
                cellStyle.RightBorderColor = HSSFColor.DarkGreen.Index; cellStyle.BottomBorderColor = HSSFColor.DarkGreen.Index; cellStyle.LeftBorderColor = HSSFColor.DarkGreen.Index; } /** * 设置相关字体样式 */
            var cellStyleFont = (HSSFFont)workbook.CreateFont(); //建立字体 //假如字体大小只须要是粗体的话直接使用下面该属性便可 //cellStyleFont.IsBold = true;
 cellStyleFont.Boldweight = boldWeight; //字体加粗
            cellStyleFont.FontHeightInPoints = fontHeightInPoints; //字体大小
            cellStyleFont.FontName = fontName;//字体（仿宋，楷体，宋体 ）
            cellStyleFont.Color = fontColor;//设置字体颜色
            cellStyleFont.IsItalic = isItalic;//是否将文字变为斜体
            cellStyleFont.Underline = underlineStyle;//字体下划线
            cellStyleFont.TypeOffset = typeOffset;//字体上标下标
            cellStyleFont.IsStrikeout = isStrikeout;//是否有删除线
 cellStyle.SetFont(cellStyleFont); //将字体绑定到样式
            return cellStyle; } } }

生成并保存指定的Excel文档内容：

using System; using System.IO; using Microsoft.AspNetCore.Hosting; using NPOI.HSSF.UserModel; using NPOI.HSSF.Util; using NPOI.SS.UserModel; using NPOI.SS.Util; using YY_Utility; namespace YY_Services { /// <summary>
    /// Excel文档生成并保存操做类 /// </summary>
    public class NpoiExcelOperationService { private static IHostingEnvironment _environment; public NpoiExcelOperationService(IHostingEnvironment iEnvironment) { _environment = iEnvironment; } /// <summary>
        /// Excel数据导出简单示例 /// </summary>
        /// <param name="resultMsg">导出结果</param>
        /// <param name="excelFilePath">保存excel文件路径</param>
        /// <returns></returns>
        public bool ExcelDataExport(out string resultMsg, out string excelFilePath) { var result = true; excelFilePath = ""; resultMsg = "successfully"; //Excel导出名称
            string excelName = "人才培训课程表"; try { //首先建立Excel文件对象
                var workbook = new HSSFWorkbook(); //建立工做表，也就是Excel中的sheet，给工做表赋一个名称(Excel底部名称)
                var sheet = workbook.CreateSheet("人才培训课程表"); //sheet.DefaultColumnWidth = 20;//默认列宽
 sheet.ForceFormulaRecalculation = true;//TODO:是否开始Excel导出后公式仍然有效（非必须）

                #region table 表格内容设置

                #region 标题样式

                //设置顶部大标题样式
                var cellStyleFont = NpoiExcelExportHelper._.CreateStyle(workbook, HorizontalAlignment.Center, VerticalAlignment.Center, 20, true, 700, "楷体", true, false, false, true, FillPattern.SolidForeground, HSSFColor.Coral.Index, HSSFColor.White.Index, FontUnderlineType.None, FontSuperScript.None, false); //第一行表单
                var row = NpoiExcelExportHelper._.CreateRow(sheet, 0, 28); var cell = row.CreateCell(0); //合并单元格 例： 第1行到第2行 第3列到第4列围成的矩形区域 //TODO:关于Excel行列单元格合并问题
                /** 第一个参数：从第几行开始合并 第二个参数：到第几行结束合并 第三个参数：从第几列开始合并 第四个参数：到第几列结束合并 **/ CellRangeAddress region = new CellRangeAddress(0, 0, 0, 5); sheet.AddMergedRegion(region); cell.SetCellValue("人才培训课程表");//合并单元格后，只需对第一个位置赋值便可（TODO:顶部标题）
                cell.CellStyle = cellStyleFont; //二级标题列样式设置
                var headTopStyle = NpoiExcelExportHelper._.CreateStyle(workbook, HorizontalAlignment.Center, VerticalAlignment.Center, 15, true, 700, "楷体", true, false, false, true, FillPattern.SolidForeground, HSSFColor.Grey25Percent.Index, HSSFColor.Black.Index, FontUnderlineType.None, FontSuperScript.None, false); //表头名称
                var headerName = new[] { "课程类型", "序号", "日期", "课程名称", "内容概要", "讲师简介" }; row = NpoiExcelExportHelper._.CreateRow(sheet, 1, 24);//第二行
                for (var i = 0; i < headerName.Length; i++) { cell = NpoiExcelExportHelper._.CreateCells(row, headTopStyle, i, headerName[i]); //设置单元格宽度
                    if (headerName[i] == "讲师简介" || headerName[i] == "内容概要") { sheet.SetColumnWidth(i, 10000); } else { sheet.SetColumnWidth(i, 5000); } } #endregion


                #region 单元格内容信息

                //单元格边框样式
                var cellStyle = NpoiExcelExportHelper._.CreateStyle(workbook, HorizontalAlignment.Center, VerticalAlignment.Center, 10, true, 400); //左侧列单元格合并 begin //TODO:关于Excel行列单元格合并问题（合并单元格后，只需对第一个位置赋值便可）
                /** 第一个参数：从第几行开始合并 第二个参数：到第几行结束合并 第三个参数：从第几列开始合并 第四个参数：到第几列结束合并 **/ CellRangeAddress leftOne = new CellRangeAddress(2, 7, 0, 0); sheet.AddMergedRegion(leftOne); CellRangeAddress leftTwo = new CellRangeAddress(8, 11, 0, 0); sheet.AddMergedRegion(leftTwo); //左侧列单元格合并 end

                var currentDate = DateTime.Now; string[] curriculumList = new[] { "艺术学", "设计学", "材料学", "美学", "心理学", "中国近代史", "管理人员的情绪修炼", "高效时间管理", "有效的目标管理", "沟通与协调" }; int number = 1; for (var i = 0; i < 10; i++) { row = NpoiExcelExportHelper._.CreateRow(sheet, i + 2, 20); //sheet.CreateRow(i+2);//在上面表头的基础上建立行
                    switch (number) { case 1: cell = NpoiExcelExportHelper._.CreateCells(row, cellStyle, 0, "公共类课程"); break; case 7: cell = NpoiExcelExportHelper._.CreateCells(row, cellStyle, 0, "管理类课程"); break; } //建立单元格列公众类课程
                    cell = NpoiExcelExportHelper._.CreateCells(row, cellStyle, 1, number.ToString()); cell = NpoiExcelExportHelper._.CreateCells(row, cellStyle, 2, currentDate.AddDays(number).ToString("yyyy-MM-dd")); cell = NpoiExcelExportHelper._.CreateCells(row, cellStyle, 3, curriculumList[i]); cell = NpoiExcelExportHelper._.CreateCells(row, cellStyle, 4, "提高，充实，拓展本身综合实力"); cell = NpoiExcelExportHelper._.CreateCells(row, cellStyle, 5, "追逐时光_" + number + "号金牌讲师！"); number++; } #endregion

                #endregion

                string folder = DateTime.Now.ToString("yyyyMMdd"); //保存文件到静态资源文件夹中（wwwroot）,使用绝对路径
                var uploadPath = _environment.WebRootPath + "/UploadFile/" + folder + "/"; //excel保存文件名
                string excelFileName = excelName + "_" + DateTime.Now.ToString("yyyyMMddHHmmss") + ".xls"; //建立目录文件夹
                if (!Directory.Exists(uploadPath)) { Directory.CreateDirectory(uploadPath); } //Excel的路径及名称
                string excelPath = uploadPath + excelFileName; //使用FileStream文件流来写入数据（传入参数为：文件所在路径，对文件的操做方式，对文件内数据的操做）
                var fileStream = new FileStream(excelPath, FileMode.OpenOrCreate, FileAccess.ReadWrite); //向Excel文件对象写入文件流，生成Excel文件
 workbook.Write(fileStream); //关闭文件流
 fileStream.Close(); //释放流所占用的资源
 fileStream.Dispose(); //excel文件保存的相对路径，提供前端下载
                var relativePositioning = "/UploadFile/" + folder + "/" + excelFileName; excelFilePath = relativePositioning; } catch (Exception e) { result = false; resultMsg = e.Message; } return result; } } }

总结：

　　学习，工做，生活都同样，不少东西都须要咱们本身动手去尝试咱们才能真正的品尝到其中的味道，收获不同的惊喜。本文主要是我的在工做和学习中的一些总结，但愿可以帮助有须要的同窗，别忘了给我star哟。布局

相关实例连接地址：

GitHub完整实例地址：

https://github.com/YSGStudyHards/NPOI-ExportWordAndExcel-ImportExcelData学习

.NET Core使用NPOI导出复杂，美观的Excel详解：

http://www.javashuo.com/article/p-yhcendvt-kx.html字体

.NET Core使用NPOI导出复杂Word详解：

http://www.javashuo.com/article/p-eqwdorft-dm.htmlspa

.NET Core使用NPOI将Excel中的数据批量导入到MySQL：

http://www.javashuo.com/article/p-blmkjyvd-mx.html设计

　　

　　

原文出处：https://www.cnblogs.com/Can-daydayup/p/12501400.html

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程