C#中为Excel单元格设置背景色的三种常用方式_Asp.net

引言

在日常报表开发中，给 excel 单元格设置背景色是提升数据可读性、区分数据层级最直接有效的方法之一。下面介绍如何使用免费的 free spire.xls for .net 库，通过 c# 代码以编程方式实现三种常见的背景设置：纯色填充、纹理填充和渐变填充。

在开始之前，先通过 nuget 包管理器安装该库：

install-package freespire.xls

然后在代码中引入必要的命名空间：

using spire.xls;
using system.drawing;

一、设置纯色背景

纯色背景是最常用的单元格填充方式，适合用于表头、数据分类标记或重点数据高亮。

// 创建工作簿并获取第一个工作表
workbook workbook = new workbook();
worksheet sheet = workbook.worksheets[0];

// 获取目标单元格，设置文本内容
cellrange cell = sheet.range["b2"];
cell.text = "纯色背景";

// 设置填充类型为纯色，并指定背景颜色
cell.style.fillpattern = excelpatterntype.solid;
cell.style.color = color.lightgreen;

// 保存文件
workbook.savetofile("cellsolidcolor.xlsx", excelversion.version2016);
workbook.dispose();

要点：fillpattern = excelpatterntype.solid 表示纯色填充；style.color 属性用于设置填充颜色。

二、设置纹理背景

纹理背景可以在纯色基础上叠加图案，让单元格更具层次感。fillpattern 属性提供了多种内置纹理样式，如角度纹理、砖块纹理、细点纹理等。

workbook workbook = new workbook();
worksheet sheet = workbook.worksheets[0];

cellrange cell = sheet.range["b2"];
cell.text = "纹理背景";

// 设置填充类型为角度纹理
cell.style.fillpattern = excelpatterntype.angle;
cell.style.color = color.lightgray;    // 背景色
cell.style.patterncolor = color.beige; // 纹理色

workbook.savetofile("cellpattern.xlsx", excelversion.version2016);
workbook.dispose();

要点：patterncolor 用于指定纹理图案的颜色，与 color（背景色）配合使用。

三、设置渐变背景

渐变背景能让单元格颜色产生平滑过渡，视觉效果更丰富。设置方式与纯色和纹理略有不同，需要通过 interior 对象来操作。

workbook workbook = new workbook();
worksheet sheet = workbook.worksheets[0];

cellrange cell = sheet.range["b2"];
cell.text = "渐变背景";

// 设置填充类型为渐变
cell.style.fillpattern = excelpatterntype.gradient;
cell.style.interior.gradient.gradientstyle = gradientstyletype.vertical;
cell.style.interior.gradient.forecolor = color.orange;
cell.style.interior.gradient.backcolor = color.lightyellow;

workbook.savetofile("cellgradient.xlsx", excelversion.version2016);
workbook.dispose();

要点：gradientstyle 控制渐变样式（水平、垂直等），forecolor 和 backcolor 分别指定渐变的两端颜色。

四、为单元格区域设置背景

除了单个单元格，range 属性同样支持为连续区域统一设置背景：

// 为表头区域设置背景色
sheet.range["a1:e1"].style.color = color.mediumseagreen;

// 为数据区域设置背景色
sheet.range["a2:a10"].style.color = color.lightyellow;

注意事项

填充类型：设置纯色背景时，务必先将 fillpattern 设为 solid，否则颜色可能不生效。
颜色命名空间：color 类位于 system.drawing 命名空间，支持预定义颜色（如 color.red）和自定义 rgb 颜色。
文件保存：savetofile 方法的第二个参数可指定 excel 版本（如 version2016、version2013 等），确保兼容性。
资源释放：操作完成后调用 dispose() 释放资源。