Magicodes.IE 2.4版本发布

时间:2022-07-26
本文章向大家介绍Magicodes.IE 2.4版本发布,主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

今天我们发布了2.4版本,这离不开大家对Magicodes.IE的支持,我们也对大家的意见以及需求不断的进行更新迭代,目前我们的发布频率平均在一周一个beta版本,一个月一个正式版本的更新,我们欢迎更多的开发者加入进来,欢迎大家来提issue以及PR。

项目地址:https://github.com/dotnetcore/Magicodes.IE。

按照惯例,我们开启了2.5版本的讨论,具体见:2.5 milestone discussion(2.5里程碑讨论),欢迎大家前来讨论。

本次发布的主要内容如下所示:

  • Excel导出支持对Enum的ValueMapping设置

在对Enum的导出中支持导出text,可以通过ValueMapping对值的一个映射

[ValueMapping(text: "小微客户", 0)]
[ValueMapping(text: "一级", 1)]
  • Excel导出支持对bool类型的ValueMapping设置 支持对bool类型的值映射
[ValueMapping(text: "yes", true)]
[ValueMapping(text: "no", false)]
  • 筛选器支持依赖注入

筛选器主要是为了满足大家能够在导入导出时支持动态处理,比如值映射等等。但是通过特性指定筛选器的话,那么如何支持依赖注入呢?不要慌,针对这个场景,我们也有考虑

在ASP.NET Core的启动类(StartUp)注册容器

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
    AppDependencyResolver.Init(app.ApplicationServices); //添加注入关系
    services.AddSingleton<IImportResultFilter, ImportResultFilterTest>();
    services.AddSingleton<IImportHeaderFilter, ImportHeaderFilterTest>();
    services.AddSingleton<IExporterHeaderFilter, TestExporterHeaderFilter1>();
}
  1. 注入的筛选器类型的优先级高于特性指定的筛选器类型,也就是当两者并存时,优先会使用注入的筛选器
  2. 注入的筛选器是全局的,当注入多种类型的筛选器时,均会执行,接下来我们还会支持更多细节控制
  3. 如果某个逻辑需要禁用所有筛选器,请参考下面部分
  4. 此功能需要2.4.0-beta2或以上版本才支持

示例如下所示:

public class TestExporterHeaderFilter2 : IExporterHeaderFilter
{
    /// <summary>
    /// 表头筛选器(修改忽略列)
    /// </summary>
    /// <param name="exporterHeaderInfo"></param>
    /// <returns></returns>
    public ExporterHeaderInfo Filter(ExporterHeaderInfo exporterHeaderInfo)
    {
        if (exporterHeaderInfo.ExporterHeaderAttribute.IsIgnore)
        {
            exporterHeaderInfo.ExporterHeaderAttribute.IsIgnore = false;
        }
        return exporterHeaderInfo;
    }
}
  • 使用IsDisableAllFilter属性禁用所有的筛选器

如果某段导入导出需要禁用所有的筛选器,我们该如何处理?仅需将IsDisableAllFilter设置为true即可。导入导出特性均已支持。

  • 导出添加AutoFitMaxRows,超过指定行数则不启用AutoFit

添加AutoFit Rows限制配置,支持超过指定行则不启用AutoFit。

[ExcelExporter(Name = "通用导出测试", AutoFitMaxRows = 5000)]
  • 支持单元格导出宽度设置
[ExporterHeader(Width = 100)]
public DateTime Time3 { get; set; }

感谢大家对Magicodes.IE的支持。关于更多发布信息大家可以参阅: https://github.com/dotnetcore/Magicodes.IE/blob/master/RELEASE.md