在 .NET 開發場景中，對 Word 文檔進行自動化格式處理是常見需求，其中設置文檔背景（顏色或圖片）是提升文檔視覺呈現的基礎操作。Free Spire.Doc for .NET 作為一款免費的 Word 文檔操作組件，無需依賴 Microsoft Office 即可完成 Word 文檔的創建、編輯與格式調整，本文將介紹如何通過該組件在 C# 中為 Word 文檔設置背景顏色或背景圖片。

一、環境準備

Free Spire.Doc for .NET 支持通過 NuGet 包管理器快速安裝，這是最便捷的方式：

• 打開 Visual Studio，創建任意 .NET 項目（如 Console App、ASP.NET Core等）；
• 右鍵項目→“管理NuGet程序包”→搜索“Free Spire.Doc”→安裝最新版本；
• 也可通過NuGet命令行安裝：

Install-Package FreeSpire.Doc

二、設置 Word 文檔背景顏色

Free Spire.Doc 提供了 Document.Background 核心屬性，需先通過 Background.Type 指定背景類型為 Color，再通過 Background.Color 設置具體顏色。

完整代碼示例：

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

namespace ConvertWordToPng
{
    class Program
    {
        static void Main(string[] args)
        {
            // 創建Document實例
            Document document = new Document();

            // 加載本地已有Word文檔
            document.LoadFromFile("Test.docx"); 

            // 指定文檔背景類型
            document.Background.Type = BackgroundType.Color;

            // 設置具體的背景顏色
            document.Background.Color = Color.AliceBlue; 

            // 保存修改後的文檔
            document.SaveToFile("純色背景.docx", FileFormat.Docx);
        }
    }
}

三、設置 Word 文檔背景圖片

設置背景圖片則只需將 Background.Type 改為 BackgroundType.Picture，再通過 Picture 屬性指定圖片路徑即可。

完整代碼示例

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

namespace ConvertWordToPng
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                // 創建Document實例並加載源文檔
                Document document = new Document();
                document.LoadFromFile("Test.docx");

                // 指定背景類型為“圖片”
                document.Background.Type = BackgroundType.Picture;
                // 設置背景圖片
                document.Background.Picture = Image.FromFile("background.jpg");

                // 保存文檔
                document.SaveToFile("PictureBackground.docx", FileFormat.Docx);

                Console.WriteLine("背景圖片設置完成！");
            }
            catch (Exception ex)
            {
                // 捕獲文件不存在、圖片格式錯誤等異常
                Console.WriteLine($"操作失敗：{ex.Message}");
            }
        }
    }
}

注意事項

• 圖片格式支持：JPG、PNG、BMP 等常見格式均可，建議使用與文檔頁面尺寸（A4 默認 210×297mm）匹配的圖片，避免顯示變形；
• 顯示模式：背景圖片默認以 “平鋪” 方式顯示，暫不支持直接設置 “拉伸” 模式，若需拉伸效果，可先通過 System.Drawing 調整圖片尺寸後再設置；
• 路徑問題：圖片路徑建議使用絕對路徑（如 D:\docs\background_img.png），避免相對路徑導致的文件查找失敗。

通過本文介紹的方法，開發者可以在 C# 應用程序中輕鬆實現文檔背景的自定義。雖然免費版本存在一些篇幅限制，但對於基本的文檔處理需求而言，它仍然是一個功能完善且易於使用的解決方案。