MiniExcel 数据导出前的格式化处理技巧

数据导出前的常见需求

在使用 MiniExcel 进行数据导出时，我们经常会遇到需要对原始数据进行格式化处理的情况。比如：

• 将布尔值 true/false 转换为"是"/"否"
• 对日期时间进行特定格式的字符串转换
• 根据数值范围显示不同的文本描述
• 对敏感信息进行脱敏处理

传统解决方案的局限性

很多开发者会考虑在导出时传入一个格式化委托函数，类似：

Func<string, string, object, object> valFmtFunc

这种方式虽然直观，但存在几个问题：

1. 增加了 API 的复杂度
2. 可能影响导出性能
3. 不够灵活，难以处理复杂的数据转换逻辑

MiniExcel 推荐的优雅解决方案

MiniExcel 团队建议采用更简单高效的方式 - 在数据源层面进行预处理。这种方法有诸多优势：

1. 关注点分离：数据处理逻辑与导出逻辑解耦
2. 灵活性高：可以处理任意复杂的数据转换
3. 性能优异：避免了导出时的额外处理开销

具体实现方法

方法一：直接修改数据源

最简单的方式是在导出前直接对数据集合进行处理：

// 原始数据
var users = GetUsers(); 

// 预处理
foreach(var user in users)
{
    user.IsActive = user.IsActive ? "是" : "否";
    user.BirthDate = user.BirthDate.ToString("yyyy-MM-dd");
}

// 导出
MiniExcel.SaveAs("output.xlsx", users);

方法二：使用 yield return 创建转换流

对于大型数据集或不想修改原始数据的情况，可以使用迭代器模式：

public IEnumerable<UserViewModel> FormatUsers(IEnumerable<User> users)
{
    foreach(var user in users)
    {
        yield return new UserViewModel {
            Name = user.Name,
            Status = user.IsActive ? "激活" : "禁用",
            FormattedDate = user.CreateTime.ToString("yyyy年MM月dd日")
        };
    }
}

// 使用
var formattedData = FormatUsers(GetUsers());
MiniExcel.SaveAs("output.xlsx", formattedData);

这种方法特别适合：

• 处理大量数据时避免内存问题
• 需要保持原始数据不变的情况
• 复杂的数据转换场景

最佳实践建议

1. 简单转换：直接在循环中修改数据属性
2. 复杂转换：创建专门的 DTO 或 ViewModel 类
3. 大数据量：使用 yield return 避免内存暴涨
4. 复用逻辑：将格式化方法封装为扩展方法或工具类

总结

MiniExcel 作为一个轻量高效的 Excel 操作库，推荐在数据导出前完成所有格式化工作。这种方式不仅保持了 API 的简洁性，还能让开发者更灵活地控制数据处理逻辑，同时保证了最佳的性能表现。通过合理使用 C# 的语言特性如迭代器和 LINQ，可以优雅地解决各种数据格式化需求。