在企業(yè)應用中，無論是生成報告、合同還是個性化信函，程序化創(chuàng)建 Word 文檔都是常見需求。E-iceblue旗下Spire系列產品是國產文檔處理領域的優(yōu)秀產品，支持國產化，幫助企業(yè)高效構建文檔處理的應用程序。Spire.Doc for .NET 提供了無需依賴 Microsoft Office 的 C# Word 文檔處理解決方案。

本文將探討兩種基于模板生成文檔的有效方法：

• 通過替換文本占位符創(chuàng)建Word文檔
• 通過替換書簽內容創(chuàng)建Word文檔

.NET Word文檔生成類庫

Spire.Doc for .NET 是一款專業(yè)的 Word 文檔處理 API，可幫助開發(fā)者實現(xiàn)多樣化的文檔操作功能。主要特性包括：

• 創(chuàng)建、讀取、編輯和轉換Word文檔
• 支持DOC、DOCX、RTF等格式
• 基于模板的文檔生成
• 郵件合并功能
• 保留原始格式

該庫特別適用于需要保證一致性和效率的企業(yè)級文檔自動化生成場景。

開始前，請從我們的官方網站下載 Spire.Doc for .NET，或通過 NuGet 包管理器使用以下命令進行安裝：

PM> Install-Package Spire.Doc

通過替換文本占位符創(chuàng)建 Word 文檔

Spire.Doc 庫中的 Document.Replace 方法可用于查找替換 Word 文檔中的特定文本，實現(xiàn)基于模板的動態(tài)文檔生成。

通過替換文本生成Word文檔的步驟如下：

• 1.文檔初始化：創(chuàng)建 Document 對象并加載模板文件
• 2.占位符定義：使用字典映射占位符（如#name#）到替換值
• 3.文本替換：Document.Replace 方法執(zhí)行區(qū)分大小寫的全字匹配替換
• 4.圖像處理：自定義 ReplaceTextWithImage 方法將文本占位符替換為圖像
• 5.文檔保存：將修改后的文檔另存為新文件

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;
using System.Drawing;

namespace CreateWordByReplacingPlaceholders
{
    class Program
    {
        static void Main(string[] args)
        {
            // 初始化一個新的 Document 對象
            Document document = new Document();

            // 加載模板 Word 文件
            document.LoadFromFile("C:\\Users\\Administrator\\Desktop\\template.docx");

            // 字典用于保存占位符及其替換內容
            Dictionary replaceDict = new Dictionary
            {
                { "#name#", "張三" },
                { "#gender#", "男" },
                { "#birthdate#", "1990年3月20日" },
                { "#address#", "金盆嶺街道" },
                { "#city#", "長沙" },
                { "#province#", "湖南" },
                { "#postal#", "410000" },
                { "#country#", "中國" }
            };

            // 用相應的值替換文檔中的占位符
            foreach (KeyValuePair kvp in replaceDict)
            {
                document.Replace(kvp.Key, kvp.Value, true, true);
            }

            // 圖像文件的路徑
            String imagePath = "C:\\Users\\Administrator\\Desktop\\portrait.png";

            // 用圖像替換照片占位符
            ReplaceTextWithImage(document, "#photo#", imagePath);

            // 保存修改后的文檔
            document.SaveToFile("ReplacePlaceholders.docx", FileFormat.Docx);

            // 釋放資源
            document.Dispose();
        }

        // 方法用于用圖像替換文檔中的占位符
        static void ReplaceTextWithImage(Document document, String stringToReplace, String imagePath)
        {
            // 從指定路徑加載圖像
            Image image = Image.FromFile(imagePath);
            DocPicture pic = new DocPicture(document);
            pic.LoadImage(image);

            // 在文檔中查找占位符
            TextSelection selection = document.FindString(stringToReplace, false, true);

            // 獲取找到的文本范圍
            TextRange range = selection.GetAsOneRange();
            int index = range.OwnerParagraph.ChildObjects.IndexOf(range);

            // 插入圖像并移除占位符文本
            range.OwnerParagraph.ChildObjects.Insert(index, pic);
            range.OwnerParagraph.ChildObjects.Remove(range);
        }
    }
}

通過替換書簽內容創(chuàng)建Word文檔

Spire.Doc中的 BookmarksNavigator 類專門用于管理 Word 文檔中的書簽，該類提供了定位書簽和替換書簽內容的方法。

通過替換書簽內容生成Word文檔的步驟如下：

• 1.文檔初始化：創(chuàng)建 Document 對象并加載模板文件
• 2.書簽內容定義：創(chuàng)建書簽名與替換內容的映射字典
• 3.書簽導航：BookmarksNavigator 類精確定位書簽位置
• 4.內容替換：ReplaceBookmarkContent 方法在更新內容時保留書簽
• 5.文檔保存：將修改后的文檔另存為新文件

using Spire.Doc;
using Spire.Doc.Documents;

namespace CreateWordByReplacingBookmarkContent
{
    class Program
    {
        static void Main(string[] args)
        {
            // 初始化一個 Document 對象并加載模板
            Document document = new Document();
            document.LoadFromFile("C:\\Users\\Administrator\\Desktop\\template.docx");

            // 定義書簽名稱及其替換值
            Dictionary replaceDict = new Dictionary
            {
                { "name", "Tech Innovations Inc." },
                { "year", "2015" },
                { "headquarter", "美國，紐約" },
                { "history", "Tech Innovations Inc. 由一群工程師和企業(yè)家創(chuàng)立，他們的愿景是徹底改變技術行業(yè)。" +
                "公司最初專注于軟件開發(fā)，后來將業(yè)務范圍擴展到人工智能和云計算解決方案。" }
            };

            // 創(chuàng)建一個 BookmarksNavigator 來管理文檔中的書簽
            BookmarksNavigator bookmarkNavigator = new BookmarksNavigator(document);

            // 用相應的值替換每個書簽的內容
            foreach (KeyValuePair kvp in replaceDict)
            {
                bookmarkNavigator.MoveToBookmark(kvp.Key); // 導航到書簽
                bookmarkNavigator.ReplaceBookmarkContent(kvp.Value, true); // 替換內容
            }

            // 保存修改后的文檔
            document.SaveToFile("ReplaceBookmarkContent.docx", FileFormat.Docx2013);

            // 釋放資源
            document.Dispose();
        }
    }
}

結論

兩種方法都提供了有效的從模板生成Word文檔的方式，但有重要差異：

1.文本替換法：

• 永久移除占位符
• 適合一次性文檔生成
• 更適合文本到圖像的替換

2.書簽替換法：

• 保留書簽以便后續(xù)更新
• 適合需要定期更新的模板

此外，Spire.Doc for .NET 還支持郵件合并功能，這為從模板動態(tài)生成文檔提供了另一種強大的方式。該功能特別適用于批量創(chuàng)建個性化文檔，例如套用信函或報告，這些文檔的數(shù)據(jù)通常來自數(shù)據(jù)庫或其他結構化數(shù)據(jù)源。

————————————————————————————————————————

關于慧都科技：

慧都科技是一家行業(yè)數(shù)字化解決方案公司，長期專注于軟件、油氣與制造行業(yè)。公司基于深入的業(yè)務理解與管理洞察，以系統(tǒng)化的業(yè)務建模驅動技術落地，幫助企業(yè)實現(xiàn)智能化運營與長期競爭優(yōu)勢。在軟件工程領域，我們提供開發(fā)控件、研發(fā)管理、代碼開發(fā)、部署運維等軟件開發(fā)全鏈路所需的產品，提供正版授權采購、技術選型、個性化維保等服務，幫助客戶實現(xiàn)技術合規(guī)、降本增效與風險可控。慧都科技E-iceblue的官方授權代理商，提供E-iceblue系列產品免費試用，咨詢，正版銷售等于一體的專業(yè)化服務。E-iceblue旗下Spire系列產品是國產文檔處理領域的優(yōu)秀產品，支持國產化，幫助企業(yè)高效構建文檔處理的應用程序。

歡迎下載|體驗更多E-iceblue產品