Magicodes.IE之导入学生数据教程

基础教程之导入学生数据

说明

本教程主要说明如果使用Magicodes.IE.Excel完成学生数据的Excel导入。

要点

• 本教程使用Magicodes.IE.Excel来完成Excel数据导入
• 需要通过创建Dto来完成导入
• Magicodes.IE.Excel可以根据Dto以及特性设置来自动生成导入的Excel模板，数据验证（包括重复验证），模板验证，读取设置，值约束和映射，输出Excel验证标注

主要步骤

1.安装包Magicodes.IE.Excel

在本篇教程中，我们仅演示使用Excel来完成学生数据的导入。我们需要在已准备好的工程中安装以下包，参考命令如下所示：

Install-Package Magicodes.IE.Excel

2.创建导入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 = "学籍号")]
          [MaxLength(30, ErrorMessage = "学籍号字数超出最大限制,请修改!")]
          public string StudentCode { get; set; }
  
          /// <summary>
          ///     姓名
          /// </summary>
          [ImporterHeader(Name = "姓名")]
          [Required(ErrorMessage = "学生姓名不能为空")]
          [MaxLength(50, ErrorMessage = "名称字数超出最大限制,请修改!")]
          public string Name { get; set; }
  
          /// <summary>
          ///     身份证号码
          /// </summary>
          [ImporterHeader(Name = "身份证号", IsAllowRepeat = false)]
          [Required(ErrorMessage = "身份证号不能为空")]
          [MaxLength(18, ErrorMessage = "身份证字数超出最大限制,请修改!")]
          public string IdCard { get; set; }
  
          /// <summary>
          ///     性别
          /// </summary>
          [ImporterHeader(Name = "性别")]
          [Required(ErrorMessage = "性别不能为空")]
          [ValueMapping("男", 0)]
          [ValueMapping("女", 1)]
          public Genders Gender { get; set; }
  
          /// <summary>
          ///     家庭地址
          ///