MiniExcel模板填充技术解析：如何正确处理动态数据行

在使用MiniExcel进行Excel模板填充时，开发者经常会遇到需要动态填充多行数据的情况。本文将通过一个典型场景，深入分析如何正确使用MiniExcel的模板功能处理动态生成的数据行。

问题背景

当我们需要在Excel模板中填充多行数据时，常见的做法是使用类似{{model.name}}这样的模板标记。然而，当这些标记对应的数据来自不同的数据源时，直接填充可能会遇到问题。

常见错误做法

开发者通常会尝试两种方法：

1. 单次填充多个数组：将不同属性的数组放在同一个字典中，结果会导致只有最后一个数组被正确填充，其他列保留模板标记。

2. 多次调用SaveAsByTemplate：试图分多次填充不同列，但会导致笛卡尔积问题，生成的数据行数是各数组长度的乘积。

正确解决方案

正确的做法是确保每行数据的所有属性都来自同一个对象。以下是推荐的方法：

使用ExpandoObject动态构建行数据

dynamic[] objects = Enumerable.Range(0, 4)
    .Select(x => new ExpandoObject())
    .ToArray();

for (int i = 0; i < 4; i++)
{
    var obj = objects[i];
    obj.model = $"A{i + 1}";
    obj.manufacturer = $"B{i + 1}";
}

var value = new Dictionary<string, object>
{
    ["data"] = objects
};

MiniExcel.SaveAsByTemplate("output.xlsx", "template.xlsx", value);

使用Dictionary替代方案

如果不习惯使用动态类型，也可以使用Dictionary<string, object>：

var rows = new List<Dictionary<string, object>>();

for (int i = 0; i < 4; i++)
{
    var row = new Dictionary<string, object>
    {
        ["model"] = $"A{i + 1}",
        ["manufacturer"] = $"B{i + 1}"
    };
    rows.Add(row);
}

var value = new Dictionary<string, object>
{
    ["data"] = rows
};

模板设计要点

在Excel模板中，应该使用统一的对象路径访问属性：

{{data.model}} {{data.manufacturer}}

而不是分别访问不同的对象：

{{model.name}} {{manufacturer.name}}

技术原理

MiniExcel的模板引擎是按行处理数据的。对于每一行，它需要能够访问到该行所有属性的完整对象。当提供多个独立的数组时，引擎无法自动将它们组合成行，因此会导致填充失败或产生笛卡尔积。

总结

处理MiniExcel模板填充时，关键在于构建正确的数据结构。每行数据应该是一个完整的对象，包含该行所有需要的属性。通过使用ExpandoObject或Dictionary，我们可以灵活地构建这种结构，确保模板填充按预期工作。

对于需要从不同数据源组合数据的情况，建议先进行数据整合，构建每行完整的对象，然后再进行模板填充，这样可以避免各种填充异常问题。