原文作者: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. C# ASP.NET递归循环生成嵌套json结构树

    1. 建立用来保存树结构数据的目标对象 public class TreeObject { public string name { get; set; } public string value { ...

  2. 使用 UniApp 实现小程序的微信登录

    微信登录思路: 在main.js 中封装公共函数,用于判断用户是否登录 在main.js 中分定义全局变量,用于存储接口地址 如果没有登录.则跳转至登录页面 进入登录页面 通过 wx.login 获取 ...

  3. RabbitMQ系列之【centos6 服务开启自启脚本】

    #!/bin/sh## rabbitmq-server RabbitMQ broker## chkconfig: - 80 05# description: Enable AMQP service p ...

  4. Arduino + RFID 读取 IC 卡 Arduino uno中获得RFID的UID 并通过串口转发RFID卡号

    RFID简介:射频识别即RFID(Radio Frequency IDentification)技术,又称无线射频识别,是一种通信技术,可通过无线电讯号识别特定目标并读写相关数据,而无需识别系统与特定 ...

  5. 附024.Kubernetes全系列大总结

    Kubernetes全系列总结如下,后期不定期更新.欢迎基于学习.交流目的的转载和分享,禁止任何商业盗用,同时希望能带上原文出处,尊重ITer的成果,也是尊重知识.若发现任何错误或纰漏,留言反馈或右侧 ...

  6. python中的importlib包

    importlib.import_module(name, package=None) 导入一个模块.参数 name 指定了以绝对或相对导入方式导入什么模块 (比如要么像这样 pkg.mod 或者这样 ...

  7. 论logstash的玩法(ELK)

    本篇文章采用的采用的是logstash-7.7.0版本,主要从如下几个方面介绍 1.logstash是什么,可以用来干啥 2.logstash的基本原理是什么 3.怎么去玩这个elk的组件logsta ...

  8. php 整数转罗马数字

    class Solution { /** * @param Integer $num * @return String */ function intToRoman($num) { $roman=[' ...

  9. 也来聊聊 HTTPS.

    前言: 网上聊 HTTPS 的文章已经数都数不过来了吧,厚着脸皮,整理下读书笔记,结合平常项目的实践,也来聊聊 HTTPS. 一.为什么需要 HTTPS? 众所周知,HTTP 协议具有无连接.不可靠. ...

  10. DNS区域传输和DNS字典爆破

    nslookup命令是已知域名的的解析记录下进行的查询.打个比方,已知sina.com这个域名有www.sina.com这条主机解析记录,就可以查询www.sina.com对应的ip以及其他相关信息. ...