“SharpDocx” C#项目中用于创建 Word 文档的轻量级模板引擎

简介:

SharpDocx是一个轻量级的模板引擎,用于创建Word文档。它允许开发者基于视图生成Word文档,这个视图本身就是一个Word文档,可以根据需要设置简单或复杂的布局。

以下是一些主要特点:

  1. 模板引擎类似Razor:可以使用类似于Razor的语法在Word模板中插入C#代码。
  2. 支持MVC模式:支持模型-视图-控制器(MVC)设计模式,可以在模板中使用自己的C#模型。
  3. 视图中嵌入C#代码:在视图中可以插入C#代码来动态生成文本、图片或表格等内容。
  4. 易于使用:生成文档的过程分为两步,首先是在Word中创建一个包含C#代码的视图,然后基于这个视图创建文档。
  5. 功能强大:除了基本的文本插入功能,SharpDocx还支持更复杂的操作,如循环和条件语句,以适应不同的文档生成需求。

gitHub地址👇

GitHub - egonl/SharpDocx: Lightweight template engine for creating Word documents

演示:

在c#项目中使用SharpDocx可以选择直接安装SharpDocx的NuGet包

复制代码
NuGet\Install-Package SharpDocx -Version 2.4.0

因为这里创建word的数据是从pgsql中获取的,因此还需安装Dapper和Npgsql的Nuget包,用于从数据库中获取数据。

我们在数据中创建一个表

创建一条测试数据,其中photo的URL是在网上随便找的一个图片的链接

然后我们在项目中创建与之对应的实体类

cs 复制代码
public class WordData
{
    public string? Title { get; set;}
    
    public string? Name { get; set; }

    public string? Sex { get; set; }

    public string? Mail { get; set; }

    public string? Phone { get; set; }

    public string? Photo { get; set; }
}

新建一个word,作为我们导出word的视图模板,在模板中,我们可以通过Model.字段名来获取实体类中字段的值。并且还可以包含 C# 代码。例如 <%= DateTime.Now %> 就是插入当前日期和时间。如下图案例中,我通过一个for循环遍历两次我的图片,稍后导出文件中我的图片就将会显示两个。

试图模板准备好之后,我们就可以来写代码了,我们通过Dapepr获取数据库中的worddata表数据,然后通过方法Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location); 获取当前项目的路径,在后面的代码中,我们读取当前项目路径下的模板.docx,即刚刚创建的视图模板(文件名可以自定义),然后我们将导出的word也保存到当前路径下,命名为结果.docx

cs 复制代码
namespace MyNamespace
{
    class MyClass
    {
        public static void Main(string[] args)
        {
            string connectionString = "Host=localhost;Database=study;Username=postgres;Password=1qazZAQ!";

            using (var connection = new NpgsqlConnection(connectionString))
            {
                connection.Open();

                string sql = "SELECT * FROM worddata Limit 1";
                var model = connection.Query<WordData>(sql).FirstOrDefault();
                model.Title = "个人资料";

                var directoryName = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
                var document = DocumentFactory.Create(Path.Combine(directoryName, "模板.docx"), model);
                document.Generate(Path.Combine(directoryName, "结果.docx"));

                connection.Close();
            }
        }
    }
}

运行项目,出现类似下面输出,即表示word创建成功

找到创建的结果.docx,打开如下

相关推荐
何以解忧唯有撸码1 天前
开源】当桌面图标开始打台球:我用 WinForms 做了一桌“真的”台球
c#·winform·自定义控件·gdi
木头左1 天前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化
国家一级摸鱼选手1 天前
[Unity]几何碰撞检测:SAT 分离轴定理详解(从数学原理到 C# 实现)
unity·c#·游戏引擎·分离轴定理(sat)·多边形相交
汤姆宝库2 天前
BPE分词器的完整实现:字节对合并与词表构建
开发语言·人工智能·c#
Risehuxyc2 天前
C# 发展历史
开发语言·c#
kyle~2 天前
C# --- 反射
开发语言·c#
暴走约伯3 天前
【VFX工具链源码拆解 09】终极工业化闭环:基于 ID 规则驱动的全自动场景建档、骨骼挂载与男转女场景迁移
unity·c#·游戏引擎·材质
用户788477316344 天前
WinForms 迁移 WPF:Upgrade Assistant 覆盖 30%,剩下 70% 我手写了六周
c#
寂寞的船4 天前
【Unity知识速递】第13期 Unity 内存泄漏排查实战:从 Memory Profiler 到 Lua 引用泄漏的生产级全链路诊断
unity·junit·c#·游戏引擎·lua
用户3721574261355 天前
C# 提取 PDF 附件:包括文档附件和页面注释附件
c#