EasyExcel：高效处理Excel的利器

秋崧欣

于 2024-09-14 08:19:41 发布

阅读量365

点赞数 4

本文链接：https://blog.csdn.net/gitblog_00557/article/details/142243400

版权

EasyExcel：高效处理Excel的利器

EasyExcel NetCore excel 导入，导出项目地址: https://gitcode.com/gh_mirrors/easy/EasyExcel

在现代数据处理中，Excel文件的导入导出是许多应用程序不可或缺的功能。无论是企业数据管理、数据分析还是日常办公，Excel文件的处理都占据了重要地位。为了满足这一需求，我们推出了EasyExcel，一个功能强大且易于集成的开源项目，旨在简化Excel文件的处理流程。

项目介绍

EasyExcel是一个基于.NET的开源项目，专注于提供高效、灵活的Excel文件导入导出功能。该项目目前集成了NPOI和EpPlus两种处理方式，用户可以根据自己的需求选择合适的方式进行集成。无论是单个还是多个Sheet的导入导出，EasyExcel都能轻松应对，并提供了丰富的配置选项，满足各种复杂的数据处理需求。

项目技术分析

技术栈

NPOI：一个强大的.NET库，用于读写Microsoft Office格式的文件，支持Excel 2003及更高版本。
EpPlus：一个功能丰富的.NET库，专门用于处理Excel 2007及更高版本的文件，支持XLSX格式。

核心功能

导入功能：支持单/多个Sheet导入、数据验证、默认值设置、字段忽略、公式计算、合并单元格取值、指定行区间导入等。
导出功能：支持样式设置、字体设置、列宽行高调整、列合并、行合并、列统计、数据格式化、指定表头导出等。

服务集成

在Startup.cs中，用户可以通过简单的配置选择使用NPOI或EpPlus进行Excel处理：

// 使用Npoi
services.AddNpoiExcel();

// 使用EpPlus
services.AddEpPlusExcel();

项目及技术应用场景

应用场景

企业数据管理：企业内部数据通常需要定期导入导出，EasyExcel提供了高效的数据处理能力，帮助企业快速完成数据迁移和备份。
数据分析：数据分析师经常需要从Excel文件中提取数据进行分析，EasyExcel的强大导入功能可以确保数据的准确性和完整性。
日常办公：在日常办公中，员工可能需要频繁处理Excel文件，EasyExcel的导出功能可以帮助用户快速生成符合要求的报表。

技术优势

灵活性：支持多种Excel处理方式，用户可以根据项目需求选择最合适的库。
易用性：通过简单的配置即可集成到项目中，无需复杂的代码编写。
扩展性：项目结构清晰，用户可以根据需要自行扩展功能。

项目特点

1. 强大的导入功能

EasyExcel提供了丰富的导入功能，包括数据验证、默认值设置、字段忽略等。用户可以通过DataAnnotations特性对导入数据进行验证，确保数据的准确性。

public class ImportTest
{
    [Display(Name = "姓名")]
    [Required(ErrorMessage = "{0}不能为空")]
    [StringLength(4, ErrorMessage = "{0}最大长度为{1}")]
    public virtual string Name { get; set; }

    [Display(Name = "手机号")]
    [RegularExpression(@"^1[3456789]\d{9}$", ErrorMessage = "{0}格式错误")]
    public virtual string Phone { get; set; }

    [Display(Name = "年龄")]
    [Required(ErrorMessage = "{0}不能为空")]
    [Range(10, 100, ErrorMessage = "{0}区间为{1}~{2}")]
    public virtual int Age { get; set; }

    [Display(Name = "成绩")]
    [Range(0, 150, ErrorMessage = "{0}区间为{1}~{2}")]
    public virtual decimal? Score { get; set; }

    [Display(Name = "日期")]
    [DefaultValue(typeof(DateTime), "2020-9-9")]
    public virtual DateTime Date { get; set; }

    [Display(Name = "学历")]
    [EnumDataType(typeof(TestEnum), ErrorMessage = "{0}值不存在")]
    public virtual TestEnum? Edu { get; set; }

    public virtual string NoDisplayName { get; set; }

    [IgnoreColumn]
    public virtual string IgnoreName { get; set; }
}

2. 丰富的导出功能

EasyExcel的导出功能同样强大，支持样式设置、字体设置、列宽行高调整、列合并、行合并、列统计等。用户可以通过特性对导出数据进行精细控制。

[HeaderStyle(ColumnAutoSize = true)]
[RowHeight(20, 30)]
[HeaderFont(Color = 14)]
[DataStyle(FillPattern = (short)FillPattern.SolidForeground, FillForegroundColor = HSSFColor.LightOrange.Index)]
[DataFont(Color = 16)]
[MergeColumn(nameof(Edu), nameof(Name11))]
public class ExportTest
{
    [Display(Name = "姓名")]
    [DataStyle(WrapText = true, FillPattern = (short)FillPattern.SolidForeground, FillForegroundColor = HSSFColor.Green.Index)]
    [DataFont(Color = 10)]
    [MergeRow]
    public virtual string Name { get; set; }

    [Display(Name = "生日")]
    [DataStyle(DataFormat = "yyyy\"年\"m\"月\"d\"日\";@")]
    [DefaultValue(typeof(DateTime), "2020-9-9")]
    public virtual DateTime? Date { get; set; }

    [Display(Name = "年龄")]
    [ColumnStats((int)FunctionEnum.Avg)]
    public virtual int Age { get; set; }

    [Display(Name = "成绩")]
    [HeaderFont(Color = 15)]
    [DataStyle(DataFormat = "#,##0.00_ ")]
    [ColumnStats((int)FunctionEnum.Avg, OffsetRow = 4)]
    [ColumnStats((int)FunctionEnum.Sum)]
    public virtual decimal? Score { get; set; }

    [Display(Name = "是否及格")]
    public virtual bool IsPass => Score > 3000;

    [Display(Name = "学历")]
    [IgnoreColumn]
    public virtual TestEnum? Edu { get; set; }

    [Display(Name = "学历文本")]
    public virtual string EduText => Edu?.ToString();

    [Display(Name = "时间")]
    public virtual TimeSpan Time => TimeSpan.FromDays(1);
}

3. 灵活的配置选项

无论是导入还是导出，EasyExcel都提供了丰富的配置选项，用户可以根据具体需求进行灵活配置。

var data = await _excelImportManager.ImportAsync<ImportTest>(stream, opt =>
{
    // opt.SheetIndex = 0;
    // opt.ValidateMode = ExcelValidateModeEnum.ThrowRow;
});

var bytes = await _excelExportManager.ExportAsync<ExportTest>(list, opt =>
{
    // opt.ExcelType = ExcelTypeEnum.Xlsx;
    // opt.SheetName = "sheet名称";
}, new[] { "姓名", "生日" });

4. 数据合并与统计

EasyExcel支持数据合并与列统计功能，用户可以通过特性对数据进行合并和统计，生成符合要求的报表。

[MergeColumn(nameof(Edu), nameof(Name11))]
[ColumnStats((int)FunctionEnum.Avg)]
public class ExportTest
{
    [MergeRow]
    public virtual string Name { get; set; }

    [ColumnStats((int)FunctionEnum.Avg, OffsetRow = 4)]
    [ColumnStats((int)FunctionEnum.Sum)]
    public virtual decimal? Score { get; set; }
}