WeihanLi.Npoi 近期更新

WeihanLi.Npoi 近期更新

Intro

最近对我的 NPOI 扩展做了一些改变，一方面提高性能，一方面修复bug，增加一些新的功能来让它更加好用，前几天发布了 1.5.0 版本，下面来介绍一下最近的更新

默认导入/导出格式变更

在 1.5.0 版本中，将默认导入/导出的excel格式从 xlsx 改为 xls 以获得更好的性能，需要注意的是 xls 格式的 excel 文件一个 sheet 最多 65535 行数据，超过的话会报错。
xls 可以有更好的性能和更优的内存分配，xlsx 可能是因为要和 xlsx 保持一致的接口，一致的编程体验才会性能有点问题，建议最好使用 xls 格式的 excel

具体的性能测试可以参考 Github，这里贴几张图：

导出数据较多，截图难以完整展示，建议看 Github 上的测试结果，或者自己拉取代码，在自己电脑上跑测试

ColumnWidth 的变化

原来的版本，会自动调整列宽，应网友的请求在 1.4.0 版本中增加了 ColumnWidth 的配置来自定义列宽，issue：https://github.com/WeihanLi/WeihanLi.Npoi/issues/30

可以通过 Attribute [Column(Width=100)] 或者通过 FluentAPI HasColumnWidth(100) 来自定义列宽

同时出于导出性能的考虑，在 1.5.0 版本中移除了自动列宽的配置，如果需要启用自动列宽，可以通过 Sheet 的配置来实现

  • Attribute 方式：[Sheet(SheetIndex = 0, SheetName = "TestSheet", AutoColumnWidthEnabled = true)]
  • FluentAPI: setting.HasSheetConfiguration(0, "SystemSettingsList", true)

OutputFormatter/InputFormatter

在 1.3.7 版本中引入了 ColumnFormatter 来使得用户可以自定义导出，让导出变得更加灵活，可以自定义一个委托来指定导出的值。

在 1.4.5 版本将 ColumnFormatter 变更为 OutputFormatter，并增加了 InputFormatter 来使得导入更加灵活

看个示例：

var setting = ExcelHelper.SettingFor<TestEntity>();
// ExcelSetting
setting.HasAuthor("WeihanLi")
    .HasTitle("WeihanLi.Npoi test")
    .HasDescription("WeihanLi.Npoi test")
    .HasSubject("WeihanLi.Npoi test");

setting.HasSheetConfiguration(0, "SystemSettingsList", 1);

// setting.HasFilter(0, 1).HasFreezePane(0, 1, 2, 1);

setting.Property(_ => _.SettingId)
    .HasColumnIndex(0);

setting.Property(_ => _.SettingName)
    .HasColumnTitle("SettingName")
    .HasColumnIndex(1);

setting.Property(_ => _.DisplayName)
    .HasOutputFormatter((entity, displayName) => $"AAA_{entity.SettingName}_{displayName}")
    .HasInputFormatter((entity, originVal) => originVal.Split(new[] { '_' })[2])
    .HasColumnTitle("DisplayName")
    .HasColumnIndex(2);

setting.Property(_ => _.SettingValue)
    .HasColumnTitle("SettingValue")
    .HasColumnIndex(3);

setting.Property(_ => _.CreatedTime)
    .HasColumnTitle("CreatedTime")
    .HasColumnIndex(4)
    .HasColumnWidth(10)
    .HasColumnFormatter("yyyy-MM-dd HH:mm:ss");

setting.Property(_ => _.CreatedBy)
    .HasColumnIndex(4)
    .HasColumnTitle("CreatedBy");

通过 OutputFormatter/InputFormatter 我们可以大大提高导出/导入的灵活性，CSV 也同样适用

小功能

  • 增加了导入 excel 时根据导入的文件内容自动调整列的顺序，这样即使不是严格按照配置的列顺序定义的excel文件也可以正常的读取
  • 增加了 ExcelHelper.LoadExcel()/ExcelHelper.ToEntityList Stream/byte[] 的重载，使得用户可以直接从上传的文件流或者一个字节数组中获取 excel 内容
  • 增加了 CsvHelper.ToEntityList(byte[] bytes)/CsvHelper.ToEntityList(Stream stream)
  • 导出 excel 时增加 sheetIndex 参数，支持按某一个 sheet 导出，原来只能导出第一个 sheet
  • 修复了 excel 导入导出不区分 string.Empty/null 的问题
  • 修复了一些 csv 导入导出的bug
  • 增加了对更多格式的读取，对于下面这些格式的文件都按照 xlsx 处理，

.xlsx：基于XML文件格式的Excel 2007工作簿缺省格式
.xlsm：基于XML且启用宏的Excel 2007工作簿
.xltx：Excel2007模板格式
.xltm：Excel 2007宏模板
.xlam：Excel 2007宏加载项
.xlsb：Excel2007为大的或复杂的工作簿新引入的非XML二进制文件格，允许优化执行和向后兼容。

More

可以查看 Github 上的 ReleaseNotes 来查看最近更新

更多详情可以参考 Github 上的 PR，现在每一次包版本的更新都会有相应的 PR，PR 合并之后通过 Azure Devops 自动发布 nuget 包

希望打造一个更好的 Excel 导入导出工具，欢迎使用，欢迎给我提 issue，bug/feature 都欢迎

原文地址：https://www.cnblogs.com/weihanli/p/11839133.html

时间： 2024-10-12 15:32:13

WeihanLi.Npoi 近期更新的相关文章

WeihanLi.Npoi 1.7.0 更新

WeihanLi.Npoi 1.7.0 更新介绍 Intro 昨天晚上发布了 WeihanLi.Npoi 1.7.0 版本,增加了 ColumnInputFormatter/ColumnOutputFormatter,又进一步增强了导入导出的灵活性,来看下面的示例 ColumnInputFormatter/ColumnOutputFormatter 示例 Model: internal abstract class BaseEntity { public int PKID { get; set;

使用 WeihanLi.Npoi 操作 CSV

使用 WeihanLi.Npoi 操作 CSV Intro 最近发现 csv 文件在很多情况下都在使用,而且经过大致了解,csv 格式简单,相比 excel 文件要小很多,读取也很是方便,而且也很通用,微软的 ml.net 的示例项目 用来训练模型的数据也是使用的 csv 来保存的,最近又发现使用 jmeter 来测试网站的性能,也可以用 csv 来参数化请求,csv 文件操作的重要性由此可见. 此前做了一个 NPOI 的扩展 WeihanLi.Npoi,支持.net45 以及 .netstan

WeihanLi.Npoi 支持 ShadowProperty 了

WeihanLi.Npoi 支持 ShadowProperty 了 Intro 在 EF 里有个 ShadowProperty (阴影属性/影子属性)的概念,你可以通过 FluentAPI 的方式来定义一个不在 .NET model 里定义的属性,只能通过 EF 里的 Change Tracker 来操作这种属性. 在导出 Excel 的时候有时候我们可能希望导出的列并不是都定义好在我们的 model 中的,有的可能只是想增加一列导出某个属性中的嵌套属性之中的某一个属性值,或者我就是单纯的想多定

WeihanLi.Npoi 根据模板导出Excel

WeihanLi.Npoi 根据模板导出Excel Intro 原来的导出方式比较适用于比较简单的导出,每一条数据在一行,数据列虽然自定义程度比较高,如果要一条数据对应多行就做不到了,于是就想支持根据模板导出,在 1.8.0 版本中引入了根据模板导出的功能 使用示例 示例模板 模板规划的可以有三种数据: Global:一个是导出的时候可以指定一些参数,作为 Global 参数,默认参数格式使用: $(Global:PropName) 的格式 Header:配置的对应属性的显示名称,默认是属性名称

DeepFaceLab 近期更新概要，“整脸”来袭！

原文地址:https://www.cnblogs.com/wangpg/p/12381221.html

中国寒龙反网络病毒联盟官网www.hackerschina.org更新公告。社工库更新公告。

大家好欢迎使用中国寒龙反网络病毒联盟在线平台. 本平台为国际公益网站SEC平台 在这里本站近期更新的社工库包括:天涯数据 乌云网会员数据 南宫数据 中南股份数据 QQ数据 和某住址社工MM数据 以及个人数据  如果再本站搜索不到您想要的资料说明本站未曾更新您相关的数据资料 不过在此您对本站搜索关键字的使用需要有一定的技巧设置如:搜索 人名字  QQ号  手机号 身份证号等等产品序列号等等,本产品序列号和商家号只供搜索中南股份和南宫的数据.谢谢使用本站. 另外本站在年底期间将会升级服务器,,升级期

近几个月无法更新课程的公告

亲爱的学员们,大家好: 近期一直在紧张的设计重庆工业文化博览园项目的工作,因频繁加班,无法经常更新课程.现向大家公布当前课程的更新情况:暂时AI实例课程讲解到100例,后续将继续更新:PS基础课程暂时完成了11章内容的讲解,后续还有两章3课时的内容,将会在近期更新:PS的高级课程也在同步策划中,待课表制定后将会同步公布,做为设计师要避免的问题课程后续也会正常更新.龙韵老师在此感谢众多学员的关心爱护以及认真学习的态度,我将会不懈努力,给大家提供更多的优质学习课程. 2018年3月18日龙韵老师 原

有关Kali更新问题的解决方法。

近期更新源遭遇诸多不顺,无非是各种依赖问题的报错夹杂着各种稀奇古怪的问题,不过既然是玩Linux,就要做好处理各种疑难杂症的准备.经过了这几天的不断尝试,今天终于解决了更新出错的问题. 本人更新源出现的问题为:“输入sudo apt-get update”出现apt-transport-https相关的报错. 解决方案如下(可能不完全是适用,所以在处理过程中谨慎输入指令): 1.输入源.问过了很多大牛,大部分说明是更新源出现了问题,而且很多人推荐使用清华源.没错!清华源是好用,但并不适合现在的我

NPOI 导出 excel 性能测试

NPOI 导出 excel 性能测试 Intro 网上看到很多人说 NPOI 的性能不行,自己写了一个 NPOI 的扩展库,于是想尝试看看 NPOI 的性能究竟怎么样,道听途说始终不如自己动手一试. 测试环境 测试工具: BenchmarkDotNet v0.11.5 EPPlus.Core.Extensions v2.3.2 EPPlus v4.5.3.1 测试代码:(Github 源码) [SimpleJob(launchCount: 1, warmupCount: 1, targetCou