.Net Core下基于NPOI对Excel、Word操作封装

C#

浏览数:295

2019-5-22

AD:资源代下载服务

本库进行了重写,如果需要请转移到下文查看:

https://www.cnblogs.com/holdengong/p/10889780.html

框架与依赖

  • 框架:.NET Standard 2.0
  • 依赖:DotNetCore.NPOI
    • https://github.com/dotnetcore/NPOI
    • http://www.cnblogs.com/savorboard/p/netcore-npoi.html

Excel导入(ExcelImportService)

  • 导出模板
  • 校验数据
    • 正则表达式校验
      • 性别
      • 邮箱
      • 身份证号
      • 手机号
      • 车牌号
      • 非空
    • 数据库存在校验
    • 数值区间
    • 字符串长度
    • 日期
    • 重复数据
  • 数据转换

Demo

public class ImportCar 
{
    [ColName("车牌号")]
    [Regex(RegexConstant.NOT_EMPTY_REGEX,ErrorMsg ="必填")]
    [DatabaseExist("cartable","carcode")]
    [Regex(RegexConstant.CAR_CODE_REGEX)]
    [Duplication]
    public string CarCode { get; set; }

    [ColName("手机号")]
    [Regex(RegexEnum.国内手机号)]
    public string Mobile { get; set; }

    [ColName("身份证号")]
    [Regex(RegexConstant.IDENTITY_NUMBER_REGEX)]
    public string IdentityNumber { get; set; }

    [ColName("姓名")]
    [MaxLength(10)]
    public string Name { get; set; }

    [ColName("性别")]
    [Regex(RegexConstant.GENDER_REGEX)]
    public GenderEnum Gender { get; set; }

    [ColName("注册日期")]
    [DateTime]
    public DateTime RegisterDate { get; set; }

    [ColName("年龄")]
    [Range(0, 150)]
    public int Age { get; set; }
}
//校验Excel数据
List<ExcelDataRow> rows = ExcelImportService.Import<ImportCar>(fileUrl, delegateNotExistInDatabase);

//错误信息入库
rows.Where(r => !r.IsValid).ToList().ForEach(
    r =>
        {
            InsertErrorLog($"第{r.RowIndex}行,{r.ErrorMsg}");
        }
    );

//正确数据转换为指定类型
List<ImportCar> importCars  = rows.Where(r => r.IsValid).FastConvert<ImportCar>().ToList();

//正确数据入库
InsertCorrectData(importCars);

Excel导出(ExcelExportService)

  • 导出Excel
  • 标记样式
    • 表头(字体、加粗、字号、颜色)
    • 列合并单元格
    • 自适应宽高
    • 自动换行

Demo

 [WrapText]
    [Header(Color =ColorEnum.RED,FontName ="微软雅黑",FontSize =12,IsBold =true)]
    public class ExportCar 
    {
        [MergeCols]
        [ColName("车牌号")]
        public string CarCode { get; set; }

        [ColName("姓名")]
        public string Name { get; set; }

        [ColName("性别")]
        public GenderEnum Gender { get; set; }

        [ColName("注册日期")]
        public DateTime RegisterDate { get; set; }

        [ColName("年龄")]
        public int Age { get; set; }
    }
List<ExportCar> list;

//业务操作,为list 赋值...
...

//导出
IWorkbook wk = ExcelExportService.Export(list);

//为IWorkbook提供了转换为byte数组的扩展方法
File.WriteAllBytes(@"c:\test\test.xls", wk.ToBytes());

导出效果

Word生成(WordExportService)

  • 根据模板生成Word
    • 插入文本
    • 插入图片

Demo

制作Word模板

定义类

public class WordCar
{
    [PlaceHolder(PlaceHolderEnum.A)]
    public string OwnerName { get; set; }

    [PlaceHolder(PlaceHolderEnum.B)]
    public string CarType { get; set; }

    //图片占位的属性类型必须为List<string>,存放图片的绝对全地址
    [PicturePlaceHolder(PlaceHolderEnum.C,"车辆照片")]
    public List<string> CarPictures { get; set; }

    [PicturePlaceHolder(PlaceHolderEnum.D,"车辆证件")]
    public List<string> CarLicense { get; set; }
}

导出

string curDir = Environment.CurrentDirectory;
    string pic1 = Path.Combine(curDir, "files", "1.jpg");
    string pic2 = Path.Combine(curDir, "files", "2.jpg");
    string pic3 = Path.Combine(curDir, "files", "3.jpg");
    string templateurl = Path.Combine(curDir, "files", "CarWord.docx");

    WordCar car = new WordCar()
    {
        OwnerName = "张三丰",
        CarType = "豪华型宾利",
        CarPictures = new List<string> { pic1, pic2 },
        CarLicense = new List<string> { pic3 }
    };

    XWPFDocument doc = WordExportService.ExportFromTemplate(templateurl, car);

    ///为XWPFDocument提供了转换为byte数组的扩展方法
    File.WriteAllBytes(@"c:\test\test.docx", doc.ToBytes());

导出效果

性能测试

Excel导入

  • 5000条数据读取和校验(首次缓存之后,700毫秒左右,校验使用了缓存提高性能)
  • 4992条有效数据的转换(80毫秒,数据转换使用了表达式树生成委托,达到了接近硬编码的性能)

github地址:
https://github.com/holdengong/Ade.OfficeService

作者:holdengong