原文作者:tanyongzheng

多Sheet导入教程

说明

本教程主要说明如何使用Magicodes.IE.Excel完成多个Sheet数据的Excel导入。

要点

  • 多个相同格式的Sheet数据导入

  • 多个不同格式的Sheet数据导入

主要步骤

1. 多个相同格式的Sheet数据导入

1.1 创建导入Sheet的Dto

主要代码如下所示:

  • 学生数据Dto

    /// <summary>
    /// 导入学生数据Dto
    /// IsLabelingError:是否标注数据错误
    /// </summary>
    [ExcelImporter(IsLabelingError = true)]
    public class ImportStudentDto
    {
    /// <summary>
    /// 序号
    /// </summary>
    [ImporterHeader(Name = "序号")]
    public long SerialNumber { get; set; }

    /// <summary>
    /// 学籍号
    /// </summary>
    [ImporterHeader(Name = "学籍号", IsAllowRepeat = false)]
    [MaxLength(, ErrorMessage = "学籍号字数超出最大限制,请修改!")]
    public string StudentCode { get; set; }

    /// <summary>
    /// 姓名
    /// </summary>
    [ImporterHeader(Name = "姓名")]
    [Required(ErrorMessage = "学生姓名不能为空")]
    [MaxLength(, ErrorMessage = "名称字数超出最大限制,请修改!")]
    public string Name { get; set; }

    /// <summary>
    /// 身份证号码
    /// </summary>
    [ImporterHeader(Name = "身份证号", IsAllowRepeat = false)]
    [Required(ErrorMessage = "身份证号不能为空")]
    [MaxLength(, ErrorMessage = "身份证字数超出最大限制,请修改!")]
    public string IdCard { get; set; }

    /// <summary>
    /// 性别
    /// </summary>
    [ImporterHeader(Name = "性别")]
    [Required(ErrorMessage = "性别不能为空")]
    [ValueMapping("男", )]
    [ValueMapping("女", )]
    public Genders Gender { get; set; }

    /// <summary>
    /// 家庭地址
    /// </summary>
    [ImporterHeader(Name = "家庭住址")]
    [Required(ErrorMessage = "家庭地址不能为空")]
    [MaxLength(, ErrorMessage = "家庭地址字数超出最大限制,请修改!")]
    public string Address { get; set; }

    /// <summary>
    /// 家长姓名
    /// </summary>
    [ImporterHeader(Name = "家长姓名")]
    [Required(ErrorMessage = "家长姓名不能为空")]
    [MaxLength(, ErrorMessage = "家长姓名数超出最大限制,请修改!")]
    public string Guardian { get; set; }

    /// <summary>
    /// 家长联系电话
    /// </summary>
    [ImporterHeader(Name = "家长联系电话")]
    [MaxLength(, ErrorMessage = "家长联系电话字数超出最大限制,请修改!")]
    public string GuardianPhone { get; set; }

    /// <summary>
    /// 学号
    /// </summary>
    [ImporterHeader(Name = "学号")]
    [MaxLength(, ErrorMessage = "学号字数超出最大限制,请修改!")]
    public string StudentNub { get; set; }

    /// <summary>
    /// 宿舍号
    /// </summary>
    [ImporterHeader(Name = "宿舍号")]
    [MaxLength(, ErrorMessage = "宿舍号字数超出最大限制,请修改!")]
    public string DormitoryNo { get; set; }

    /// <summary>
    /// QQ
    /// </summary>
    [ImporterHeader(Name = "QQ号")]
    [MaxLength(, ErrorMessage = "QQ号字数超出最大限制,请修改!")]
    public string QQ { get; set; }

    /// <summary>
    /// 民族
    /// </summary>
    [ImporterHeader(Name = "民族")]
    [MaxLength(, ErrorMessage = "民族字数超出最大限制,请修改!")]
    public string Nation { get; set; }

    /// <summary>
    /// 户口性质
    /// </summary>
    [ImporterHeader(Name = "户口性质")]
    [MaxLength(, ErrorMessage = "户口性质字数超出最大限制,请修改!")]
    public string HouseholdType { get; set; }

    /// <summary>
    /// 联系电话
    /// </summary>
    [ImporterHeader(Name = "学生联系电话")]
    [MaxLength(, ErrorMessage = "手机号码字数超出最大限制,请修改!")]
    public string Phone { get; set; }

    /// <summary>
    /// 状态
    /// 测试可为空的枚举类型
    /// </summary>
    [ImporterHeader(Name = "状态")]
    public StudentStatus? Status { get; set; }

    /// <summary>
    /// 备注
    /// </summary>
    [ImporterHeader(Name = "备注")]
    [MaxLength(, ErrorMessage = "备注字数超出最大限制,请修改!")]
    public string Remark { get; set; }

    /// <summary>
    /// 是否住校(宿舍)
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public bool? IsBoarding { get; set; }

    /// <summary>
    /// 所属班级id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public Guid ClassId { get; set; }

    /// <summary>
    /// 学校Id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public Guid? SchoolId { get; set; }

    /// <summary>
    /// 校区Id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public Guid? CampusId { get; set; }

    /// <summary>
    /// 专业Id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public Guid? MajorsId { get; set; }

    /// <summary>
    /// 年级Id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public Guid? GradeId { get; set; }
    }

1.2 创建导Excel入Dto

主要代码如下所示:

  • 学生数据Dto

     public class ImportClassStudentDto
    {

    [ExcelImporter(SheetName = "1班导入数据")]
    public ImportStudentDto Class1Students { get; set; }

    [ExcelImporter(SheetName = "2班导入数据")]
    public ImportStudentDto Class2Students { get; set; }

    }

    如上述代码所示,我们定义了班级学生数据Dto,主要注意事项如下:

    1. Excel的Dto类上面不用导入相关的加特性。

    2. Excel的Dto类里面的属性未Sheet的Dto类型,ExcelImporter特性离的SheetName参数来设置具体某一个Sheet名。

1.3 Excel模板

注意:Excel里的多个Sheet列名必须一致(对应同一个Sheet的Dto类型)

模板目录:src\Magicodes.ExporterAndImporter.Tests\TestFiles\Import\班级学生基础数据导入.xlsx

第一个Sheet:

第二个Sheet:

1.4 导入代码

IExcelImporter Importer = new ExcelImporter();

var filePath = Path.Combine(Directory.GetCurrentDirectory(), "TestFiles", "Import", "班级学生基础数据导入.xlsx");

//获取到的导入结果为一个字典类型,Key为Sheet名,Value为Sheet对应的数据
var importDic = await Importer.ImportSameSheets<ImportClassStudentDto, ImportStudentDto>(filePath);

//遍历字典,获取每个Sheet的数据
foreach (var item in importDic)
{
var import = item.Value;
//导入的Sheet数据
var studentList = import.Data.ToList();
}

2. 多个不同格式的Sheet数据导入

2.1 创建导入Sheet的Dto

主要代码如下所示:

  • 学生数据Dto同上

  • 缴费日志数据Dto :

      
    /// <summary>
    /// 缴费日志导入Dto
    /// </summary>
    /// <autogeneratedoc />
    [ExcelImporter(IsLabelingError = true)]
    public class ImportPaymentLogDto
    {
    /// <summary>
    /// 学生姓名
    /// </summary>
    [ImporterHeader(Name = "学生姓名")]
    [Required(ErrorMessage = "学生姓名为必填项")]
    [MaxLength(, ErrorMessage = "学生姓名不能超过15位")]
    public string Name { get; set; }

    /// <summary>
    /// 身份证号码
    /// </summary>
    [ImporterHeader(Name = "身份证号码")]
    [Required(ErrorMessage = "身份证号码为必填项")]
    [MaxLength(, ErrorMessage = "身份证号码不能超过18位")]
    [MinLength(, ErrorMessage = "身份证号码不能小于18位")]
    public string IdCard { get; set; }

    /// <summary>
    /// 缴费类型
    /// </summary>
    [ImporterHeader(Name = "缴费类型")]
    [Required(ErrorMessage = "缴费类型为必填项")]
    public string CostType { get; set; }

    /// <summary>
    /// 金额
    /// </summary>
    [ImporterHeader(Name = "金额")]
    [Range(0.01, , ErrorMessage = "收费金额区间为1~100万")]
    [Required(ErrorMessage = "金额为必填项")]
    public decimal Amount { get; set; }

    /// <summary>
    /// 缴费日期
    /// </summary>
    [ImporterHeader(Name = "缴费日期")]
    [MaxLength(, ErrorMessage = "缴费日期不能超过8位")]
    [RegularExpression("\\d{6,8}", ErrorMessage = "缴费日期只能输入6到8位数字例如201908/20190815")]
    public string PayDate { get; set; }

    /// <summary>
    /// 收据编号
    /// 多个使用逗号分隔,仅线下收据
    /// </summary>
    [ImporterHeader(Name = "收据编号")]
    [MaxLength(, ErrorMessage = "收据编号不能超过200位")]
    public string ReceiptCodes { get; set; }

    /// <summary>
    /// 备注
    /// </summary>
    [ImporterHeader(Name = "备注")]
    [MaxLength(, ErrorMessage = "备注不能超过500位")]
    public string Remarks { get; set; }

    /// <summary>
    /// 创建时间
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public DateTime? CreationTime { get; set; }

    /// <summary>
    /// 收费项目id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public int? ChargeProjectId { get; set; }

    /// <summary>
    /// 班级Id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public Guid? ClassId { get; set; }

    /// <summary>
    /// 班级名称
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public string ClassName { get; set; }

    /// <summary>
    /// 年级Id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public Guid? GradeId { get; set; }

    /// <summary>
    /// 年级信息
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public string GradeName { get; set; }

    /// <summary>
    /// 专业Id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public Guid? MajorId { get; set; }

    /// <summary>
    /// 专业信息
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public string MajorName { get; set; }

    /// <summary>
    /// 校区Id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public Guid? CampusId { get; set; }

    /// <summary>
    /// 校区名称
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public string CampusName { get; set; }

    /// <summary>
    /// 学校Id
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public Guid? SchoolId { get; set; }

    /// <summary>
    /// 学校信息
    /// </summary>
    [ImporterHeader(IsIgnore = true)]
    public string SchoolName { get; set; }
    }

2.2 创建导Excel入Dto

主要代码如下所示:

  • 班级学生基础数据及缴费流水数据Dto

      public  class ImportStudentAndPaymentLogDto
    {
    [ExcelImporter(SheetName = "1班导入数据")]
    public ImportStudentDto Class1Students { get; set; }

    [ExcelImporter(SheetName = "缴费数据")]
    public ImportPaymentLogDto Class2Students { get; set; }
    }

2.3 Excel模板

模板目录:src\Magicodes.ExporterAndImporter.Tests\TestFiles\Import\学生基础数据及缴费流水号导入.xlsx

学生基础数据Sheet:

缴费流水号Sheet:

2.4 导入代码

  public  class ImportStudentAndPaymentLogDto
{
[ExcelImporter(SheetName = "1班导入数据")]
public ImportStudentDto Class1Students { get; set; }

[ExcelImporter(SheetName = "缴费数据")]
public ImportPaymentLogDto Class2Students { get; set; }
}

Reference

https://github.com/dotnetcore/Magicodes.IE

开源导入导出库Magicodes.IE 多sheet导入教程的更多相关文章

  1. ASP.NET 开源导入导出库Magicodes.IE 多Sheet导入教程

    多Sheet导入教程 说明 本教程主要说明如何使用Magicodes.IE.Excel完成多个Sheet数据的Excel导入. 要点 多个相同格式的Sheet数据导入 多个不同格式的Sheet数据导入 ...

  2. ASP.NET 开源导入导出库Magicodes.IE 完成Csv导入导出

    Magicodes.IE Csv导入导出 说明 本章主要说明如何使用Magicodes.IE.Csv进行Csv导入导出. 主要步骤 1.安装包Magicodes.IE.Csv Install-Pack ...

  3. ASP.NET 开源导入导出库Magicodes.IE 完成Excel图片导入导出

    Magicodes.IE Excel图片导入导出 为了更好的根据实际功能来迭代,从2.2的里程碑规划开始,我们将结合社区的建议和意见来进行迭代,您可以点此链接来提交您的意见和建议: https://g ...

  4. 开源导入导出库Magicodes.IE 导出教程

    要点 导出特性 如何导出Excel表头 如何导出数据.如何进行数据的切割.如何使用筛选器 导出特性 ExporterAttribute Name: 名称(当前Sheet 名称) HeaderFontS ...

  5. .NET Core开源导入导出库 Magicodes.IE 2.3发布

    在2.3这一版本的更新中,我们迎来了众多的使用者.贡献者,在这个里程碑中我们也添加并修复了一些功能.对于新特点的功能我将在下面进行详细的描述,当然也欢迎更多的人可以加入进来,再或者也很期待大家来提is ...

  6. .NET 开源导入导出库 Magicodes.IE 2.5发布

    今天我们发布了2.5版本,这当然也离不开大家对Magicodes.IE的支持,今天我也是跟往常一样列举了该版本一些重要的更新内容. 当然也要说一下,在这个版本中我们设计了全新的LOGO Excel导出 ...

  7. ASP.NET 开源导入导出库Magicodes.IE 导出Pdf教程

    基础教程之导出Pdf收据 说明 本教程主要说明如何使用Magicodes.IE.Pdf完成Pdf收据导出 要点 导出PDF数据 自定义PDF模板 导出单据 如何批量导出单据 导出特性 PdfExpor ...

  8. Magicodes.IE 2.3重磅发布——.NET Core开源导入导出库

    在2.3这一版本的更新中,我们迎来了众多的使用者.贡献者,在这个里程碑中我们也添加并修复了一些功能.对于新特点的功能我将在下面进行详细的描述,当然也欢迎更多的人可以加入进来,再或者也很期待大家来提is ...

  9. Spring MVC 实现Excel的导入导出功能(1:Excel的导入)

    简介 这篇文章主要记录自己学习上传和导出Excel时的一些心得,企业办公系统的开发中,经常会收到这样的需求:批量录入数据.数据报表使用 Excel 打开,或者职能部门同事要打印 Excel 文件,而他 ...

随机推荐

  1. 实践案例丨基于ModelArts AI市场算法MobileNet_v2实现花卉分类

    概述 MobileNetsV2是基于一个流线型的架构,它使用深度可分离的卷积来构建轻量级的深层神经网,此模型基于 MobileNetV2: Inverted Residuals and Linear ...

  2. ES 复合查询

    ES在查询过程中比较多遇到符合查询,既需要多个字段过滤也需要特殊情况处理,本文简单介绍几种查询组合方便快捷查询ES. bool布尔查询有一个或者多个布尔子句组成     filter 只过滤符合条件的 ...

  3. 如何向这些CA来申请数字证书呢?

    申请的过程大致是: 1.自己本地先生成一对密匙,然后拿着自己的公匙以及其他信息(比如说企业名称啊什么的)去CA申请数字证书. 2.CA在拿到这些信息后,会选择一种单向Hash算法(比如说常见的MD5) ...

  4. 解决Celery 在Windows中搭建和使用的版本

    官网:http://docs.celeryproject.org/en/latest/faq.html#does-celery-support-windows 描述如下:表示Celery 4.0版本以 ...

  5. git安装和第一次提交过程

    1,新建文件夹test,运行命令 git init 2,找到test的.git文件夹,打开之后找到config文件,在最后边加上一句话 [user] email=your email name=you ...

  6. Android学习笔记Intent二

    上篇随笔大概写了了Intent学习的大纲,这篇通过代码理解下Intent的ComponentName属性的使用 ComponentName,中文意思是组件名称,通过Intent的setsetCompo ...

  7. Dotnet core基于ML.net的销售数据预测实践

    ML.net已经进到了1.5版本.作为Microsoft官方的机器学习模型,你不打算用用?   一.前言 ML.net可以让我们很容易地在各种应用场景中将机器学习加入到应用程序中.这是这个框架很重要的 ...

  8. 写给大忙人的Redis主从复制,花费五分钟让你面试不尴尬

    相信很多小伙伴都已经配置过主从复制,但是对于redis主从复制的工作流程和常见问题很多都没有深入的了解.咔咔这次用时俩天时间给大家整理一份redis主从复制的全部知识点. 本文实现所需环境 cento ...

  9. Redis源码阅读一:简单动态字符串SDS

    源码阅读基于Redis4.0.9 SDS介绍 redis 127.0.0.1:6379> SET dbname redis OK redis 127.0.0.1:6379> GET dbn ...

  10. Python 为什么不支持 i++ 自增语法,不提供 ++ 操作符?

    在 C/C++/Java 等等语言中,整型变量的自增或自减操作是标配,它们又可分为前缀操作(++i 和 --i)与后缀操作(i++ 和 i--),彼此存在着一些细微差别,各有不同的用途. 这些语言的使 ...