news 2026/6/9 18:34:54

一个开源、简单、快速的 .NET Word 模板引擎

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
一个开源、简单、快速的 .NET Word 模板引擎

致力于挖掘功能强大、性能优越、创新前沿且简单易用的 C#/.NET 开源框架、项目、类库与工具。助力 .NET 开发者轻松解锁并运用这些实用的宝藏资源,提升开发效率与创新能力!

项目概述

MiniWord 是一个功能强大且易于使用的 .NET Word 模板导出引擎,适用于各种需要动态生成 Word 文档的场景。其跨平台、无需 Office 依赖、简单易用的特点使得它成为开发者理想的文档生成工具。

应用场景

MiniWord 适用于需要动态生成 Word 文档的各种场景,包括但不限于:

  • 报告生成:根据数据库查询结果或业务逻辑动态生成报告。

  • 合同生成:根据用户输入的信息自动填充合同模板。

  • 证书制作:根据用户数据自动生成证书或奖状。

  • 邮件合并:批量生成个性化的邮件或信函。

  • 数据导出:将应用程序中的数据导出为 Word 文档,便于分享和打印。

功能模块

MiniWord 主要包含以下几个功能模块:

模板引擎

  • 模板设计:用户可以使用 Word 设计模板,通过特定的标签占位符来标记需要动态替换的内容。

  • 数据绑定:支持将数据模型绑定到模板中的标签,实现数据的动态替换。

数据替换

  • 文本替换:支持简单的文本替换,将模板中的标签替换为实际的数据值。

  • 图片替换:支持将模板中的图片标签替换为实际的图片。

  • 列表和表格:支持将数组或列表数据绑定到模板中的列表或表格,实现动态生成多行内容。

  • 条件判断:支持在模板中使用条件判断语句,根据数据值决定是否显示某些内容。

  • 循环:支持在模板中使用循环语句,动态生成重复的内容块。

输出格式

  • 文件输出:支持将生成的 Word 文档保存为文件。

  • 字节数组输出:支持将生成的 Word 文档转换为字节数组,便于在网络中传输或存储在数据库中。

  • 流输出:支持将生成的 Word 文档写入到流中,便于直接响应 HTTP 请求。

快速入门

模板遵循“所见即所得”的设计,模板和标签的样式会被完全保留

var value = new Dictionary<string, object>(){["title"] = "Hello MiniWord"}; MiniSoftware.MiniWord.SaveAsByTemplate(outputPath, templatePath, value);

表格替换

标签值为 IEmerable<Dictionary<string,object>>类别

代码例子:

var value = new Dictionary<string, object>() { ["TripHs"] = new List<Dictionary<string, object>> { new Dictionary<string, object> { { "sDate",DateTime.Parse("2022-09-08 08:30:00")}, { "eDate",DateTime.Parse("2022-09-08 15:00:00")}, { "How","Discussion requirement part1"}, { "Photo",new MiniWordPicture() { Path = PathHelper.GetFile("DemoExpenseMeeting02.png"), Width = 160, Height = 90 }}, }, new Dictionary<string, object> { { "sDate",DateTime.Parse("2022-09-09 08:30:00")}, { "eDate",DateTime.Parse("2022-09-09 17:00:00")}, { "How","Discussion requirement part2 and development"}, { "Photo",new MiniWordPicture() { Path = PathHelper.GetFile("DemoExpenseMeeting01.png"), Width = 160, Height = 90 }}, }, } }; MiniWord.SaveAsByTemplate(path, templatePath, value);

二级列表

Tag 是 IEnumerable<MiniWordForeach> 类别. 使用方式{{foreach 和 endforeach}}.

var value = new Dictionary<string, object>() { ["TripHs"] = new List<Dictionary<string, object>> { new Dictionary<string, object> { { "sDate", DateTime.Parse("2022-09-08 08:30:00") }, { "eDate", DateTime.Parse("2022-09-08 15:00:00") }, { "How", "Discussion requirement part1" }, { "Details", new List<MiniWordForeach>() { new MiniWordForeach() { Value = new Dictionary<string, object>() { {"Text", "Air"}, {"Value", "Airplane"} }, Separator = " | " }, new MiniWordForeach() { Value = new Dictionary<string, object>() { {"Text", "Parking"}, {"Value", "Car"} }, Separator = " / " } } } } } }; MiniWord.SaveAsByTemplate(path, templatePath, value);

源码地址

https://gitee.com/dotnetchina/MiniWord

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/10 15:37:00

VSCode下Qiskit环境部署实战(仅需4步,新手也能秒上手)

第一章&#xff1a;VSCode下Qiskit环境部署概览在量子计算快速发展的背景下&#xff0c;Qiskit作为IBM推出的开源量子软件开发工具包&#xff0c;已成为研究人员和开发者构建量子算法的重要选择。结合Visual Studio Code&#xff08;VSCode&#xff09;这一轻量级但功能强大的代…

作者头像 李华
网站建设 2026/6/10 15:32:36

54、深入探索Shell编程:命令、变量与模式匹配的综合指南

深入探索Shell编程:命令、变量与模式匹配的综合指南 1. 字符与符号 在Shell编程里,各种字符和符号都有着特殊用途。比如感叹号(!)用于shell历史操作,像 ! 可用于历史命令的引用和操作,其使用涵盖历史单词的引用(126 - 128)以及修饰符(128 - 31)等。美元符号($)…

作者头像 李华
网站建设 2026/6/9 21:09:15

微服务分布式事务实战:从数据一致性到故障恢复全方案

某电商平台在 “会员积分兑换商品” 业务中出现严重数据不一致问题&#xff1a;用户积分成功扣减&#xff08;积分服务&#xff09;&#xff0c;但商品库存未同步减少&#xff08;库存服务&#xff09;&#xff0c;导致用户 “花了积分却没拿到商品”&#xff0c;客服投诉量激增…

作者头像 李华
网站建设 2026/6/10 15:55:45

XUnity.AutoTranslator终极指南:让Unity游戏秒变中文的免费神器

还在为看不懂的日文游戏而苦恼吗&#xff1f;XUnity.AutoTranslator这款强大的Unity游戏翻译工具&#xff0c;能够实时将游戏文本转换为中文&#xff0c;彻底打破语言障碍。无论你是新手玩家还是资深游戏爱好者&#xff0c;这款免费的开源工具都能让你的游戏体验瞬间升级&#…

作者头像 李华
网站建设 2026/6/10 15:52:42

3个关键步骤!用闲鱼自动化工具实现高效运营管理

3个关键步骤&#xff01;用闲鱼自动化工具实现高效运营管理 【免费下载链接】xianyu_automatize [iewoai]主要用于实现闲鱼真机自动化&#xff08;包括自动签到、自动擦亮、统计宝贝数据&#xff09; 项目地址: https://gitcode.com/gh_mirrors/xia/xianyu_automatize 想…

作者头像 李华