C#代码轻松实现为Word段落或文本添加底纹_Asp.net

在 microsoft word 中，底纹功能可以为指定的文本或段落添加背景颜色。合理使用底纹不仅能够提升文档的视觉效果，还可以帮助区分不同内容区域，使文档结构更加清晰、内容更易阅读。

本文将介绍如何使用 c# 为 word 中的段落或指定文本添加底纹，并通过 .net 文档处理库实现这一功能。

安装 .net 文档处理库

首先，需要将相关文档处理库中的 dll 文件添加到 .net 项目中作为引用。

pm> install-package spire.doc

使用 c# 为 word 段落添加底纹

在 c# 中，可以通过设置段落的背景颜色，为 word 文档中的指定段落添加底纹。相关 .net 文档处理库通常提供对应的属性和方法来实现这一功能。以下是具体步骤：

创建一个 document 实例。
使用 document.loadfromfile() 方法加载 word 文档。
通过 document.sections[] 属性获取指定的节。
通过 section.paragraphs[] 属性获取指定的段落。
使用 paragraph.format.backcolor 属性设置段落的背景颜色。
使用 document.savetofile() 方法保存处理后的文档。

完整示例代码如下：

using spire.doc;
using spire.doc.documents;
using system.drawing;
namespace wordparagrahshade
{
    class program
    {
        static void main(string[] args)
        {
            // 创建一个 document 实例
            document document = new document();
            // 加载 word 文档
            document.loadfromfile("sample.docx");
            // 获取第一个节
            section section = document.sections[0];
            // 获取第二个段落
            paragraph paragaph = section.paragraphs[1];
            // 设置段落的背景颜色
            paragaph.format.backcolor = color.yellow;
            // 保存处理后的文档
            document.savetofile("paragraphbackground.docx", fileformat.docx);
        }
    }
}

使用 c# 为 word 中的指定文本添加底纹

如果只需要为 word 中的指定文本添加底纹，可以先通过 paragraph.find() 方法查找目标文本，获取其文本范围，然后通过 textrange.characterformat.textbackgroundcolor 属性为该文本范围设置背景颜色。具体步骤如下：

创建一个 document 实例。
使用 document.loadfromfile() 方法加载 word 文档。
通过 document.sections[] 属性获取指定的节。
通过 section.paragraphs[] 属性获取指定的段落。
使用 paragraph.find() 方法查找指定文本。
使用 textselection.getasonerange() 方法获取找到文本的范围。
通过 textrange.characterformat.textbackgroundcolor 属性设置文本范围的背景颜色。
使用 document.savetofile() 方法保存文档。

完整示例代码如下：

using spire.doc;
using spire.doc.documents;
using spire.doc.fields;
using system.drawing;

namespace shadetext
{
    class program
    {
        static void main(string[] args)
        {
            // 创建一个 document 实例
            document document = new document();

            // 加载 word 文档
            document.loadfromfile("sample.docx");

            // 获取第一个节
            section section = document.sections[0];

            // 获取第一个段落
            paragraph paragaph = section.paragraphs[0];

            // 在段落中查找指定文本
            textselection selection = paragaph.find("spire.doc for .net", true, false);

            // 获取找到文本的文本范围
            textrange range = selection.getasonerange();

            // 设置文本范围的背景颜色
            range.characterformat.textbackgroundcolor = color.red;

            // 保存处理后的文档
            document.savetofile("textbackground.docx", fileformat.docx);
        }
    }
}

知识扩展

在 c# 中为 word 段落或文本添加底纹（背景色或图案），常用的方法有三种：使用 aspose.words、spire.doc 或 open xml sdk。
底纹可以作用于整个段落（paragraph）或特定的文本范围（run）。下面分别给出三种库的实现方案。

准备工作

创建一个 .net 控制台项目（.net 6+ 或 framework），根据需要安装对应的 nuget 包。

库	安装命令	说明
aspose.words	`install-package aspose.words`	商业库，功能强大
spire.doc	`install-package spire.doc`	商业库（有免费版限制）
open xml sdk	`install-package documentformat.openxml`	免费开源，微软官方

商业库需要授权，免费版通常有水印或页数限制。

方案一：使用 aspose.words（推荐）

1. 为整个段落设置底纹（背景色）

using aspose.words;
using aspose.words.drawing;

public static void addshadingtoparagraph(string docpath, string savepath)
{
    document doc = new document(docpath);
    documentbuilder builder = new documentbuilder(doc);

    // 插入一个段落
    builder.writeln("这是一个有底纹的段落。");

    // 获取第一个段落
    paragraph para = doc.firstsection.body.paragraphs[0];

    // 设置段落底纹（背景色）
    para.paragraphformat.shading.backgroundpatterncolor = color.lightblue;

    doc.save(savepath);
}

2. 为特定文本（run）设置底纹

文本底纹实际上是给 run 对象设置字符样式中的底纹。

public static void addshadingtotext(string docpath, string savepath)
{
    document doc = new document(docpath);
    documentbuilder builder = new documentbuilder(doc);

    builder.writeln("普通文本。");
    builder.write("这段文字有");
    builder.font.shading.backgroundpatterncolor = color.yellow;
    builder.write("黄色底纹");
    builder.font.shading.clearformatting(); // 清除底纹
    builder.write("。后续正常。");

    doc.save(savepath);
}

说明：font.shading 控制当前字体样式，会影响之后写入的文本，直到清除或修改。

方案二：使用 spire.doc

1. 给段落添加底纹

using spire.doc;
using spire.doc.fields;
using system.drawing;

public static void addshadingtoparagraphspire(string docpath, string savepath)
{
    document doc = new document();
    doc.loadfromfile(docpath);

    section section = doc.sections[0];
    paragraph para = section.addparagraph();
    para.appendtext("这段落有灰色底纹。");

    // 设置段落背景色
    para.format.backcolor = color.lightgray;

    doc.savetofile(savepath, fileformat.docx2016);
}

2. 给文本范围（textrange）添加底纹

public static void addshadingtotextspire(string docpath, string savepath)
{
    document doc = new document();
    doc.loadfromfile(docpath);

    section section = doc.sections[0];
    paragraph para = section.addparagraph();

    textrange range = para.appendtext("带绿色底纹的文字");
    range.characterformat.backcolor = color.green;

    doc.savetofile(savepath, fileformat.docx2016);
}

spire.doc 的免费版会在文档中添加水印，且限制操作页数。

方案三：使用 open xml sdk（免费开源，底层控制）

open xml sdk 直接操作 word 的 xml 结构，需要手动创建底纹元素。

1. 为段落添加底纹

using documentformat.openxml.packaging;
using documentformat.openxml.wordprocessing;
using documentformat.openxml;
using system.linq;
public static void addshadingtoparagraphopenxml(string docpath, string savepath)
{
    using (wordprocessingdocument doc = wordprocessingdocument.open(docpath, true))
    {
        body body = doc.maindocumentpart.document.body;
        // 获取第一个段落
        paragraph para = body.descendants<paragraph>().firstordefault();
        if (para != null)
        {
            // 创建段落属性对象
            paragraphproperties pp = para.getfirstchild<paragraphproperties>();
            if (pp == null)
            {
                pp = new paragraphproperties();
                para.prependchild(pp);
            }
            // 创建底纹属性（背景色）
            shading shading = new shading()
            {
                val = shadingpatternvalues.clear, // 纯色
                color = "auto",
                fill = "ff0000" // 红色（十六进制 rgb）
            };
            pp.shading = shading;
        }
        doc.save();
    }
}

2. 为特定文本（run）添加底纹

public static void addshadingtorunopenxml(string docpath, string savepath)
{
    using (wordprocessingdocument doc = wordprocessingdocument.open(docpath, true))
    {
        body body = doc.maindocumentpart.document.body;

        // 获取第一个段落
        paragraph para = body.descendants&lt;paragraph&gt;().firstordefault();
        if (para != null)
        {
            // 创建 run 并添加文本
            run run = new run();
            runproperties rp = new runproperties();

            // 设置字符底纹（背景色）
            shading shading = new shading()
            {
                val = shadingpatternvalues.clear,
                color = "auto",
                fill = "00ff00" // 绿色
            };
            rp.shading = shading;

            run.appendchild(rp);
            run.appendchild(new text("绿色底纹的文字"));

            para.appendchild(run);
        }

        doc.save();
    }
}