在报表分发、合同归档、机密数据共享等场景中,给 Excel 文档添加水印是一种简单且实用的版权标识手段。水印既可以由图片构成,也可以由文字构成。对中文使用者来说,"机密"、"内部资料"、"严禁外传"等中文字样的水印更贴近实际业务。
本文将演示如何使用一个免费 .NET Excel 库在 C# 中为 Excel 文档添加水印,对比两种实现思路——页眉图片水印和背景图片水印,并补充一段生成中文字符水印图片的辅助代码,方便在没有现成水印图片时也能直接使用。
安装
可以通过 NuGet 将该库引入到项目中。
NuGet 包管理器控制台
Install-Package FreeSpire.XLS.NET CLI
dotnet add package FreeSpire.XLS
安装完成后,在代码中引入命名空间Spire.Xls即可使用。
两种水印方案对比
Excel 的水印并不是真正的"水印"对象,本质上是通过页眉图片或工作表背景图片模拟出来的,因此两种方案在打印、视图、定位等方面表现差异明显。
| 对比项 | 页眉图片水印 | 背景图片水印 |
|---|---|---|
| 打印输出 | 随文档一同被打印 | 不出现在打印结果中 |
| 视图可见性 | 仅在"页面布局"或"分页预览"模式下可见,普通视图看不到 | 所有视图模式下都可见 |
| 位置控制 | 需要手动调整页眉区域的边距来让图片居中 | 自动铺满整个工作表数据区 |
| 视觉一致性 | 受分页影响,相邻页可能错位 | 整张工作表只显示同一张图片 |
页眉图片水印
- 优点:水印会出现在文档的最终打印输出中,适合必须打印归档的场景。
- 缺点:在 Excel 的 "Normal" 视图下不可见,只能在 "Page Layout" 或 "Page Break Preview" 下看到;要把图片调到页面正中央,要小心调整图片上方和左侧的页边距。
背景图片水印
- 优点:水印图片覆盖整张工作表,呈现效果一致。
- 缺点:水印不会出现在打印输出中。
方案一:通过页眉添加图片水印
下述示例遍历文档中的所有工作表,并把同一张水印图片设置到页眉中央位置。
using Spire.Xls; using System.Drawing; namespace AddWatermarkToExcelUsingHeader { class Program { static void Main(string[] args) { // 创建 Workbook 对象 Workbook workbook = new Workbook(); // 加载 Excel 文档 workbook.LoadFromFile(@"C:\Users\Administrator\Desktop\Input.xlsx"); // 加载水印图片 Image image = Image.FromFile(@"C:\Users\Administrator\Desktop\confidential.png"); // 遍历文档中所有工作表 for (int i = 0; i < workbook.Worksheets.Count; i++) { // 获取指定工作表 Worksheet worksheet = workbook.Worksheets[i]; // 在页眉中央插入图片占位符 worksheet.PageSetup.CenterHeader = "&G"; // 将图片设置到页眉中央 worksheet.PageSetup.CenterHeaderImage = image; } // 保存结果文件 workbook.SaveToFile("AddWatermark.xlsx", ExcelVersion.Version2016); // 释放资源 workbook.Dispose(); } } }注意:&G是 Excel 自身的页眉图片占位符,所有文本(如"机密"字样)应直接烘焙到图片中,而不是写在CenterHeader字符串里。
方案二:将图片设置为工作表背景
下述示例把图片作为工作表的背景水印,适用于仅屏幕查看、需要强可见性的场景。
using Spire.Xls; using System.Drawing; namespace AddWatermarkToExcelUsingBackground { class Program { static void Main(string[] args) { // 创建 Workbook 对象 Workbook workbook = new Workbook(); // 加载 Excel 文档 workbook.LoadFromFile(@"C:\Users\Administrator\Desktop\Input.xlsx"); // 加载水印图片 Bitmap bitmapImage = new Bitmap(Image.FromFile(@"C:\Users\Administrator\Desktop\sample.png")); // 遍历文档中所有工作表 for (int i = 0; i < workbook.Worksheets.Count; i++) { // 获取指定工作表 Worksheet worksheet = workbook.Worksheets[i]; // 将图片设置为该工作表的背景 worksheet.PageSetup.BackgroundImage = bitmapImage; } // 保存结果文件 workbook.SaveToFile("AddWatermark.xlsx", ExcelVersion.Version2016); // 释放资源 workbook.Dispose(); } } }中文文字水印的生成
实际业务里,水印常常是"机密资料"、"内部文件"等动态文字,没必要每次都由设计师提供 PNG。可以借助System.Drawing在内存中绘制一张透明背景的中文水印图片,再交给方案一或方案二复用。
using System.Drawing; using System.Drawing.Drawing2D; using System.Drawing.Imaging; public static class ChineseWatermarkHelper { /// <summary> /// 生成中文文字水印图片(透明背景,倾斜 -30°) /// </summary> /// <param name="text">水印文本,如 "机密资料"</param> /// <param name="width">画布宽度</param> /// <param name="height">画布高度</param> /// <returns>带有透明背景的 Bitmap 对象</returns> public static Bitmap Create(string text, int width, int height) { Bitmap bmp = new Bitmap(width, height, PixelFormat.Format32bppArgb); using (Graphics g = Graphics.FromImage(bmp)) { g.Clear(Color.Transparent); g.SmoothingMode = SmoothingMode.AntiAlias; g.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAliasGridFit; using (Font font = new Font("Microsoft YaHei", 60, FontStyle.Bold)) using (SolidBrush brush = new SolidBrush(Color.FromArgb(60, Color.Red))) { // 计算文字尺寸并居中 SizeF size = g.MeasureString(text, font); // 平移到画布中心,再旋转,使绘制出的文字位于中央 g.TranslateTransform(width / 2f, height / 2f); g.RotateTransform(-30); g.DrawString(text, font, brush, -size.Width / 2f, -size.Height / 2f); } } return bmp; } }调用时,只需把生成的Bitmap直接传给上面的两种方案即可:
// 生成中文文字水印图片 Bitmap watermarkImage = ChineseWatermarkHelper.Create("机密资料", 800, 600); // 用作工作表背景水印 workbook.Worksheets[0].PageSetup.BackgroundImage = watermarkImage;字体一致性建议
System.Drawing默认按系统已安装的字体渲染中文字符,在不同环境(例如 Linux 服务器、容器化部署)下可能出现字体丢失、文字变成方块的情况。生产环境中建议:
- 将字体文件(如
msyh.ttc、simhei.ttf)打包到应用中; - 通过
PrivateFontCollection加载私有字体后再传入Font构造函数; - 或预先把所有可能用到的水印文本渲染成 PNG,作为静态资源随项目分发。
方案选型参考
| 场景 | 推荐方案 |
|---|---|
| 报表需要打印、归档,文档要长期留存 | 方案一:页眉图片水印 |
| 仅屏幕查看、内部演示,注重直观可见 | 方案二:背景图片水印 |
总结
免费 .NET Excel 库本身并不直接提供"水印"对象,而是借助页眉图片或工作表背景图片这两种机制实现。把任意一张Image/Bitmap交给CenterHeaderImage或BackgroundImage,就完成了水印的添加;再结合一段简短的中文文字绘图代码,就可以在不依赖外部素材的前提下,灵活生成"机密资料"、"内部文件"等贴合中文业务场景的水印。
实际项目里,建议把"图片生成 + 水印注入"封装成独立的工具方法,对外只暴露文件路径、水印文字、可见性等少量参数,这样在面对多业务线、多模板时复用成本最低。