快捷導(dǎo)航

使用C#設(shè)置Word文檔背景顏色或背景圖片

更新時間：2026年02月03日 08:23:58 作者：咕白m625

在 .NET 開發(fā)場景中,對 Word 文檔進行自動化格式處理是常見需求,其中設(shè)置文檔背景提升文檔視覺呈現(xiàn)的基礎(chǔ)操作,本文將介紹如何通過該組件在 C# 中為 Word 文檔設(shè)置背景顏色或背景圖片,需要的朋友可以參考下

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

一、環(huán)境準備

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

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

Install-Package FreeSpire.Doc

二、設(shè)置 Word 文檔背景顏色

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

完整代碼示例：

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

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

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

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

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

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

三、設(shè)置 Word 文檔背景圖片

設(shè)置背景圖片則只需將 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
            {
                // 創(chuàng)建Document實例并加載源文檔
                Document document = new Document();
                document.LoadFromFile("Test.docx");

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

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

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

注意事項

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

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

以上就是使用C#設(shè)置Word文檔背景顏色或背景圖片的詳細內(nèi)容，更多關(guān)于C#設(shè)置Word背景顏色或圖片的資料請關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: