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

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

• 通過替換文本占位符創建Word文檔
• 通過替換書簽內容創建Word文檔

.NET Word文檔生成類庫

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

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

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

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

PM> Install-Package Spire.Doc

通過替換文本占位符創建 Word 文檔

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

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

• 1.文檔初始化：創建 Document 對象并加載模板文件
• 2.占位符定義：使用字典映射占位符（如#name#）到替換值
• 3.文本替換：Document.Replace 方法執行區分大小寫的全字匹配替換
• 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);
        }
    }
}

通過替換書簽內容創建Word文檔

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

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

• 1.文檔初始化：創建 Document 對象并加載模板文件
• 2.書簽內容定義：創建書簽名與替換內容的映射字典
• 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. 由一群工程師和企業家創立，他們的愿景是徹底改變技術行業。" +
                "公司最初專注于軟件開發，后來將業務范圍擴展到人工智能和云計算解決方案。" }
            };

            // 創建一個 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.書簽替換法：

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

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

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

關于慧都科技：

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

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