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