PAYATHON 2026

MiniExcel 模板无集合名时如何指定数据单元格

数据小陈

结论

数据库字段 LastName、FirstName 不需要额外加名字。使用 SaveAsByTemplate 导出多行集合时,需要给传给模板的集合本身一个顶层键。模板里的根名称取自 SaveAsByTemplate 第三个参数对象的属性名或字典键,VB 代码里的局部变量名不会自动成为这个根名称。

常见情况如下:

  • 如果直接传 rdr 或 List(Of ExcelData),模板里写 {{LastName}} 或 {{eds.LastName}},通常匹配不到。
  • 多行模板应传 New With {.eds = eds} 或 Dictionary(Of String, Object),模板写 {{eds.LastName}}。
  • {{LastName}} 只适用于上下文本身就是一个对象的单条数据,例如传入 New With {.LastName = "张"};不要直接拿它对应 List(Of ExcelData)。

推荐写法

先把 SqlDataReader 转成 List(Of ExcelData),再把带命名集合的对象传给模板:

Dim eds As New List(Of ExcelData)

Using con As New SqlConnection(ConString)
    Using com As New SqlCommand("Get_ExcelData", con)
        com.CommandType = CommandType.StoredProcedure
        con.Open()

        Using rdr = com.ExecuteReader()
            While rdr.Read()
                eds.Add(New ExcelData With {
                    .LastName = If(rdr.IsDBNull("LastName"), Nothing, rdr.GetString("LastName")),
                    .FirstName = If(rdr.IsDBNull("FirstName"), Nothing, rdr.GetString("FirstName")),
                    .JointMember = If(rdr.IsDBNull("JointMember"), Nothing, rdr.GetString("JointMember"))
                })
            End While
        End Using
    End Using
End Using

Dim templateData = New With {.eds = eds}
MiniExcel.SaveAsByTemplate(FileName, TemplateName, templateData, configuration:=config)

模板单元格这样写:

{{eds.LastName}}
{{eds.FirstName}}
{{eds.JointMember}}

不想用匿名对象,也可以用字典,效果一样:

Dim templateData As New Dictionary(Of String, Object) From {
    {"eds", eds}
}

MiniExcel.SaveAsByTemplate(FileName, TemplateName, templateData, configuration:=config)

为什么之前不工作

调用 MiniExcel.SaveAsByTemplate(FileName, TemplateName, eds, configuration:=config) 时,eds 只是 VB 代码里的变量名,不会自动变成模板上下文中的键。模板渲染看到的是 List(Of ExcelData) 本身,它没有名为 eds 的属性,也没有名为 LastName 的顶层属性,因此 {{eds.LastName}} 和 {{LastName}} 都取不到值。

另外,不建议把 SqlDataReader 直接传给 SaveAsByTemplate。模板绑定需要能按名称访问属性或字典键;先读成 List(Of T) 或 DataTable 更稳妥,也方便处理 DBNull。

注意事项

  1. 模板占位符要和对象属性名或字典键一致,大小写也要统一,避免出现 {{eds.lastname}} 与 .LastName 混用。
  2. 多行集合要在模板中保留集合占位符所在行,让 MiniExcel 按集合展开;可以先用两三行数据做一个最小模板验证。
  3. 输出文件和模板文件不要用同一个路径,避免覆盖模板。
  4. 空值处理要和 ExcelData 的属性类型匹配;属性是 String 时,Nothing 与 DBNull 的转换需要提前确认。
  5. configuration 参数按现有配置继续传即可;上面只改模板数据上下文,其他导出逻辑不变。

备注:内容仅供参考。