让 .Net 更方便的导入导出 Excel

最新推荐文章于 2020-11-02 15:50:13 发布

dotNET跨平台

最新推荐文章于 2020-11-02 15:50:13 发布

阅读量252

点赞数

让 .Net 更方便的导入导出Excel

Intro

因为前一段时间需要处理一些 excel 数据，主要是导入/导出操作，将 Excel 数据转化为对象再用程序进行处理和分析，没有找到比较满意的库，于是就自己造了一个轮子，屏蔽掉了 xlsx 与 xls 的差别，屏蔽了 Npoi 操作 Excel 的细节，提供简单容易上手的 api。完整的 API 可以参考这里的文档：https://weihanli.github.io/WeihanLi.Npoi/docs/api/WeihanLi.Npoi.html

导入/导出

直接添加 nuget 包引用 WeihanLi.Npoi

根据 excel 文件获取一个 IWorkbook 对象，支持 *.xls/*.xlsx

IWorkbook workbook = ExcelHelper.LoadExcel("excelFilePath");

将 Excel 文件的第一个 sheet 里的内容转成 list 对象

List<TEntity> entityList = ExcelHelper.ToEntityList<TEntity>("excelFilePath");

将 Excel 文件的第一个 sheet 里的内容转成 DataTable 对象

DataTable dataTable = ExcelHelper.ToDataTable("excelFilePath");

将 list 对象导出到 Excel 字节数组

List<TEntity> entityList = ExcelHelper.ToEntityList<TEntity>("excelFilePath");	
entityList.ToExcelBytes();

将 list 对象导出到 Excel 文件

List<TEntity> entityList = ExcelHelper.ToEntityList<TEntity>("excelFilePath");	
entityList.ToExcelFile("excelFilePath");

自定义配置

默认的导入导出是按照属性名为导出的列名称的，如果不能满足或者想要自定义某些属性不导出或设置导出顺序，可以通过配置实现

提供了两种配置方式，一种是使用 Attribute 方式来配置，第二种是使用 FluentAPI 方式配置（推荐，对代码无侵入性）

1. Attributes

在要导入导出的属性上设置 ColumnAttribute 来自定义导出的列名称或排序或忽略

添加 SheetAttribute 来设置导出的excel sheet名称等

for example:

public class TestEntity	
{	
    [Column("Id")]	
    public int PKID { get; set; }	
    [Column("Bill Title")]	
    public string BillTitle { get; set; }	
    [Column("Bill Details")]	
    public string BillDetails { get; set; }	
    [Column("CreatedBy")]	
    public string CreatedBy { get; set; }	
    [Column("CreatedTime")]	
    public DateTime CreatedTime { get; set; }	
}	
public class TestEntity1	
{	
    [Column("Username")]	
    public string Username { get; set; }	
    [Column(IsIgnored = true)]	
    public string PasswordHash { get; set; }	
    [Column("Amount")]	
    public decimal Amount { get; set; } = 1000M;	
    [Column("WechatOpenId")]	
    public string WechatOpenId { get; set; }	
    [Column("IsActive")]	
    public bool IsActive { get; set; }	
}

2. FluentApi (Recommend)

var setting = ExcelHelper.SettingFor<TestEntity>();	
// ExcelSetting	
setting.HasAuthor("WeihanLi")	
    .HasTitle("WeihanLi.Npoi test")	
    .HasDescription("")	
    .HasSubject("");	
setting.HasSheetConfiguration(0, "System Settings");	
setting.HasFilter(0, 1)	
    .HasFreezePane(0, 1, 2, 1);	
setting.Property(_ => _.SettingId)	
    .HasColumnIndex(0);	
setting.Property(_ => _.SettingName)	
    .HasColumnTitle("SettingName")	
    .HasColumnIndex(1);	
setting.Property(_ => _.DisplayName)	
    .HasColumnFormatter((entity, displayName) => $"AAA_{entity.SettingName}_{displayName}")	
    .HasColumnTitle("DisplayName")	
    .HasColumnIndex(2);	
setting.Property(_ => _.SettingValue)	
    .HasColumnTitle("SettingValue")	
    .HasColumnIndex(3);	
setting.Property(_ => _.CreatedTime)	
    .HasColumnTitle("CreatedTime")	
    .HasColumnIndex(5)	
    .HasColumnFormatter("yyyy-MM-dd HH:mm:ss");	
setting.Property(_ => _.CreatedBy)	
    .HasColumnIndex(4)	
    .HasColumnTitle("CreatedBy");	
setting.Property(_ => _.UpdatedBy).Ignored();	
setting.Property(_ => _.UpdatedTime).Ignored();	
setting.Property(_ => _.PKID).Ignored();

想要更多自定义选项，参考示例项目，或者给我提 issue