原文作者：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. KVM Web管理平台 WebVirtMgr

    WebVirtMgr介绍 WebVirtMgr是一个KVM管理平台,让kvm管理变得更为可视化,对中小型kvm应用场景带来了更多方便.WebVirtMgr采用几乎纯Python开发,其前端是基于Pyt ...

  2. 启动centos 不带桌面

    方法一:非systemd系统 #runlevel N 5 //表示运行级别为5 #init 3 //将运行级别设为3,此时桌面服务关闭 运行级别说明: 3 多用户模式.允许多用户登录系统,是系统默认的 ...

  3. 局域网访问电脑中VMware虚拟机

    场景 你在自己的台式机或笔记本中使用VMware Workstation搭建了一个虚拟机系统,如Debian.Fedora等Linux系统.现在你希望使用局域网中另一台电脑访问你电脑上的虚拟机系统,怎 ...

  4. css固定宽高DIV内部元素垂直居中的方法

    应用案例 案例是这样的,一个外层div,高宽是固定的,但是里面内容不是固定的.很多朋友的做法是头部加一个padding或者margin,这样,里面内容显得貌似是居中了,但是假如内容变化,这样头部的固定 ...

  5. Java 多线程基础（五）线程同步

    Java 多线程基础(五)线程同步 当我们使用多个线程访问同一资源的时候,且多个线程中对资源有写的操作,就容易出现线程安全问题. 要解决上述多线程并发访问一个资源的安全性问题,Java中提供了同步机制 ...

  6. Centos7 安装 redis6 的部分问题总结

    首先把redis.tar.gz 解压到你想要的路径 检查一下安装环境: yum -y install gcc yum -y install epel-release 执行 make 和 make in ...

  7. YII2.0安装教程，数据库配置前后台

    1.首先下载yii-advanced-app-2.0.6.tgz 我本地服务用的是Apache 2.解压到E:\wamp\www\yii2目录下面将目录advanced下所有文件剪切到 E:\wamp ...

  8. docker部署dubbo怎么实现外部主机访问服务？

    dubbo在分布式项目中太常见了,docker也是现在热门的项目,然而docker的网络配置也是非常麻烦的一件事情,这里给大家介绍一下dubbo实现跨服务器访问服务配置 docker-compose. ...

  9. python动态柱状图图表可视化：历年软科中国大学排行

    本来想参照:https://mp.weixin.qq.com/s/e7Wd7aEatcLFGgJUDkg-EQ搞一个往年编程语言动态图的,奈何找不到数据,有数据来源的欢迎在评论区留言. 这里找到了一个 ...

  10. java基础 内部类详解

    什么是内部类? 1.内部类也是一个类: 2.内部类位于其他类声明内部. 内部类的常见类型 1.成员内部类 2.局部内部类 3.匿名内部类 4.静态内部类 简单示例 /** * 外部类 * */ pub ...