突破限制：EPPlus库中Excel页眉页脚文本颜色设置完全指南 🚀

2026-02-04 04:14:44作者：管翌锬

EPPlus是一款功能强大的.NET Excel操作库，让开发者能够轻松创建、读取和修改Excel电子表格。本文将详细介绍如何在EPPlus中设置Excel页眉页脚的文本颜色，帮助你打造更具个性化和专业性的Excel文档。

🌟 了解页眉页脚文本结构

在开始设置颜色之前，我们需要先了解EPPlus中页眉页脚文本的基本结构。EPPlus提供了ExcelHeaderFooterText类来处理页眉页脚内容，该类位于src/EPPlus/ExcelHeaderFooter.cs文件中。

每个页眉页脚包含三个对齐区域：

左对齐文本 (LeftAligned)
居中对齐文本 (Centered)
右对齐文本 (RightAligned)

这些区域通过ExcelHeaderFooterTextCollection类进行管理，你可以向其中添加文本、页码、文件名等元素。

🎨 发现字体颜色设置的秘密

在EPPlus中，设置页眉页脚文本颜色的关键是使用特殊的格式代码。通过搜索源代码，我们发现了一个重要的常量定义：

public const string FontColor = @"&K";

这个常量定义在src/EPPlus/ExcelHeaderFooter.cs文件的第315行。它告诉我们，可以使用&K前缀来设置文本颜色。

🚀 实战：设置页眉页脚文本颜色

基本颜色设置语法

设置页眉页脚文本颜色的基本语法如下：

&K[颜色代码][文本内容]&K

其中[颜色代码]是一个6位的十六进制颜色值，不需要包含#符号。

完整示例代码

下面是一个完整的示例，展示如何在EPPlus中设置页眉页脚文本颜色：

// 获取工作表的页眉页脚对象
var headerFooter = worksheet.HeaderFooter;

// 设置页眉左对齐文本为红色
headerFooter.OddHeader.LeftAligned.AddText("&KFF0000这是红色文本&K");

// 设置页眉居中文本为蓝色
headerFooter.OddHeader.Centered.AddText("&K0000FF这是蓝色文本&K");

// 设置页脚右对齐文本为绿色
headerFooter.OddFooter.RightAligned.AddText("&K00FF00这是绿色文本&K");

颜色代码使用技巧

常见颜色代码参考：
- 红色：FF0000
- 蓝色：0000FF
- 绿色：00FF00
- 黑色：000000
- 白色：FFFFFF
使用Excel内置颜色选择器：你可以在Excel中使用颜色选择器获取所需颜色的十六进制代码，然后直接在EPPlus中使用。
颜色重置：记得在文本结束处使用&K重置颜色，避免影响后续文本。

📚 高级应用：结合其他格式设置

EPPlus的页眉页脚文本不仅支持颜色设置，还支持其他格式：

// 结合字体大小和颜色
headerFooter.OddHeader.LeftAligned.AddText("&KFF0000&14这是14号红色文本&K");

// 结合粗体和颜色
headerFooter.OddHeader.Centered.AddText("&K0000FF&B这是蓝色粗体文本&K&B");

其中&14表示字体大小为14，&B表示粗体。