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

前言

在使用 MiniExcel 进行数据导出时，开发者经常会遇到需要对原始数据进行格式化处理的需求。比如将布尔值转换为"是/否"、日期格式化为特定字符串、数字添加千分位分隔符等。本文将详细介绍在 MiniExcel 中实现数据格式化的几种有效方法。

数据预处理方案

直接修改数据源

最直接的方式是在将数据传递给 MiniExcel 的 SaveAs 方法前，先对数据源进行预处理：

// 原始数据
var orders = GetOrdersFromDatabase();

// 预处理数据
foreach(var order in orders)
{
    // 格式化日期
    order.FormattedDate = order.CreateTime.ToString("yyyy-MM-dd");
    
    // 格式化布尔值
    order.StatusDisplay = order.IsCompleted ? "已完成" : "进行中";
}

// 导出处理后的数据
MiniExcel.SaveAs("orders.xlsx", orders);

这种方案的优点是简单直接，缺点是会修改原始数据对象。

使用 LINQ 投影创建新对象

如果不希望修改原始对象，可以使用 LINQ 的 Select 方法创建新对象：

var formattedOrders = orders.Select(o => new 
{
    ID = o.Id,
    Date = o.CreateTime.ToString("yyyy-MM-dd"),
    Status = o.IsCompleted ? "已完成" : "进行中",
    Amount = o.TotalAmount.ToString("C")
});

MiniExcel.SaveAs("orders.xlsx", formattedOrders);

这种方法不会影响原始数据，但需要重新定义所有需要导出的属性。

使用 yield return 实现流式处理

对于大数据量场景，可以使用 yield return 实现流式处理，避免内存消耗：

public IEnumerable<FormattedOrder> FormatOrders(IEnumerable<Order> orders)
{
    foreach(var order in orders)
    {
        yield return new FormattedOrder
        {
            ID = order.Id,
            FormattedDate = order.CreateTime.ToString("yyyy-MM-dd"),
            StatusText = order.IsCompleted ? "已完成" : "进行中"
        };
    }
}

// 使用
var formattedData = FormatOrders(orders);
MiniExcel.SaveAs("orders.xlsx", formattedData);

这种方法结合了前两种方案的优点：不修改原始数据且内存效率高。

高级格式化技巧

自定义格式化函数

可以创建通用的格式化函数来处理特定类型的值：

public static class ExcelFormatters
{
    public static string FormatDate(DateTime? date)
    {
        return date?.ToString("yyyy-MM-dd") ?? "无日期";
    }
    
    public static string FormatCurrency(decimal amount)
    {
        return amount.ToString("C");
    }
}

// 使用
var formattedData = orders.Select(o => new 
{
    Date = ExcelFormatters.FormatDate(o.CreateTime),
    Amount = ExcelFormatters.FormatCurrency(o.TotalAmount)
});

动态列处理

如果需要根据条件动态决定列的格式，可以使用字典或动态对象：

var dynamicData = orders.Select(o => 
{
    dynamic row = new ExpandoObject();
    row.ID = o.Id;
    
    if(needsDetailedDate)
    {
        row.Date = o.CreateTime.ToString("yyyy-MM-dd HH:mm:ss");
    }
    else
    {
        row.Date = o.CreateTime.ToString("yyyy-MM-dd");
    }
    
    return row;
});

MiniExcel.SaveAs("dynamic.xlsx", dynamicData);

总结

MiniExcel 虽然不直接提供数据格式化委托功能，但通过合理的数据预处理可以轻松实现各种格式化需求。开发者可以根据具体场景选择：

1. 直接修改数据源 - 适合简单场景
2. LINQ 投影 - 适合中小数据量且需要保留原始数据的场景
3. yield return 流式处理 - 适合大数据量场景
4. 自定义格式化函数 - 适合需要复用格式化逻辑的场景

这些方法灵活组合，可以满足绝大多数 Excel 导出时的数据格式化需求。