C# 设置 Word 文档背景颜色/背景图
<p>在 .NET 开发场景中，对 Word 文档进行自动化格式处理是常见需求，其中设置文档背景（颜色或图片）是提升文档视觉呈现的基础操作。Free Spire.Doc for .NET 作为一款免费的 Word 文档操作组件，无需依赖 Microsoft Office 即可完成 Word 文档的创建、编辑与格式调整，本文将介绍如何通过该组件在 C# 中为 Word 文档设置背景颜色或背景图片。</p><h2 id="一环境准备">一、环境准备</h2>
<p>Free Spire.Doc for .NET 支持通过 NuGet 包管理器快速安装，这是最便捷的方式：</p>
<ul>
<li>打开 Visual Studio，创建任意 .NET 项目（如 Console App、ASP.NET Core等）；</li>
<li>右键项目→“管理NuGet程序包”→搜索“Free Spire.Doc”→安装最新版本；</li>
<li>也可通过NuGet命令行安装：</li>
</ul>
<pre><code class="language-bash">Install-Package FreeSpire.Doc
</code></pre>
<h2 id="二设置-word-文档背景颜色">二、设置 Word 文档背景颜色</h2>
<p>Free Spire.Doc 提供了 <code>Document.Background</code> 核心属性，需先通过 <code>Background.Type</code> 指定背景类型为 <code>Color</code>，再通过 <code>Background.Color</code> 设置具体颜色。</p>
<p><strong>完整代码示例：</strong></p>
<pre><code class="language-csharp">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);
}
}
}
</code></pre>
<h2 id="三设置-word-文档背景图片">三、设置 Word 文档背景图片</h2>
<p>设置背景图片则只需将 <code>Background.Type</code> 改为 <code>BackgroundType.Picture</code>，再通过 <code>Picture</code> 属性指定图片路径即可。</p>
<p><strong>完整代码示例</strong></p>
<pre><code class="language-csharp">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}");
}
}
}
}
</code></pre>
<h3 id="注意事项">注意事项</h3>
<ul>
<li>图片格式支持：JPG、PNG、BMP 等常见格式均可，建议使用与文档页面尺寸（A4 默认 210×297mm）匹配的图片，避免显示变形；</li>
<li>显示模式：背景图片默认以 “平铺” 方式显示，暂不支持直接设置 “拉伸” 模式，若需拉伸效果，可先通过 <code>System.Drawing</code> 调整图片尺寸后再设置；</li>
<li>路径问题：图片路径建议使用绝对路径（如 <code>D:\docs\background_img.png</code>），避免相对路径导致的文件查找失败。</li>
</ul>
<hr>
<p>通过本文介绍的方法，开发者可以在 C# 应用程序中轻松实现文档背景的自定义。虽然免费版本存在一些篇幅限制，但对于基本的文档处理需求而言，它仍然是一个功能完善且易于使用的解决方案。</p><br><br>
来源：https://www.cnblogs.com/jazz-z/p/19565731
頁:
[1]