当前位置：首页 > news >正文

NPOI - ConditionalFormattingRule

news 2025/7/4 2:58:43

NPOI 给xls(xlsx)创建条件格式

获取 XSSFSheetConditionalFormatting 对象

初始化

IWorkbook _workbook = new XSSFWorkbook();
ISheet _dataSheet = _workbook.GetSheet("template");
ISheetConditionalFormatting fcs = _dataSheet.SheetConditionalFormatting;

调用 XSSFSheetConditionalFormatting 的 CreateConditionalFormattingRule 方法

该类总共提供了6个CreateConditionalFormattingRule重载方法，可以根据需求选择

CreateConditionalFormattingRule(String formula);
CreateConditionalFormattingRule(ComparisonOperator comparisonOperation, String formula);
CreateConditionalFormattingRule(ComparisonOperator comparisonOperation, String formula1, String formula2);
CreateConditionalFormattingRule(IconSet iconSet);
CreateConditionalFormattingRule(XSSFColor color);
CreateConditionalFormattingRule(ExtendedColor color);

示例代码

CellRangeAddress range = CellRangeAddress.ValueOf("A1:A100");
//创建名称管理器（可以通过execl INDIRECT函数获取其引用位置的值集合）
IName sexName = _workbook.CreateName();
sexName.NameName = "Sex";
sexName.RefersToFormula = $"Value!$A$1:$A$2";
// 该rule表示A列只允许填写 Sex 指定的值。注意 A1 没有加 $,所以如果是第二列，则代表的是 A2，可参考第5点cell引用
IConditionalFormattingRule rule = fcs.CreateConditionalFormattingRule($"=AND(ISNA(MATCH(A1,INDIRECT(\"Sex\"),0)),TRIM(A1)<>\"\")");
XSSFPatternFormatting fillColor = (XSSFPatternFormatting)rule.CreatePatternFormatting();
fillColor.FillBackgroundColor = IndexedColors.Violet.Index;
//自定义颜色
fillColor.FillBackgroundColorColor = new XSSFColor(new byte[] { 112, 48, 160 });
fillColor.FillPattern = FillPattern.SolidForeground;
fcs.AddConditionalFormatting(new CellRangeAddress[] { range }, rule);

ComparisonOperator 参数

ComparisonOperator 总共提供了 Between，NotBetween，Equal，NotEqual，GreaterThan，LessThan，GreaterThanOrEqual，LessThanOrEqual 几种比较操作，适用于将当前cell的值和固定值做比较

formula 参数

如果和 comparisonOperation 参数共同使用，则返回该公式计算后的值，和cell值做比较；
如果只有 formula 参数，则以 formula 计算后的值为 true/false 应用格式

将格式应用于整列

NPOI 随着格式的数量增加，渲染格式的耗时会大幅的提高（如果20个格式需要1分钟，那么200个格式可能需要半个小时），所以应尽量批量应用公式。
而批量应用公式的时候，需要理解清楚xlsx的cell引用（https://www.zhihu.com/question/372122014），比如$A $1 和 A 1 ，加了$ 符合的表示固定引用，不加表示相对引用，相对引用则会随单元格的区域变动而变动

某列重复值规则

var formula = "COUNTIF($D$2:$D$101,D2)>1"

全部代码如下

IWorkbook _workbook = new XSSFWorkbook();
ISheet _dataSheet = _workbook.GetSheet("template");
ISheetConditionalFormatting fcs = _dataSheet.SheetConditionalFormatting;
CellRangeAddress range = CellRangeAddress.ValueOf("A1:A100");
//创建名称管理器（可以通过execl INDIRECT函数获取其引用位置的值集合）
IName sexName = _workbook.CreateName();
sexName.NameName = "Sex";
sexName.RefersToFormula = $"Value!$A$1:$A$2";// 该rule表示A列只允许填写 Sex 指定的值。注意 A1 没有加 $,所以如果是第二列，则代表的是 A2，可参考第5点cell引用
IConditionalFormattingRule rule = fcs.CreateConditionalFormattingRule($"=AND(ISNA(MATCH(A1,INDIRECT(\"Sex\"),0)),TRIM(A1)<>\"\")");
XSSFPatternFormatting fillColor = (XSSFPatternFormatting)rule.CreatePatternFormatting();
fillColor.FillBackgroundColor = IndexedColors.Violet.Index;
//自定义颜色
fillColor.FillBackgroundColorColor = new XSSFColor(new byte[] { 112, 48, 160 });
fillColor.FillPattern = FillPattern.SolidForeground;
fcs.AddConditionalFormatting(new CellRangeAddress[] { range }, rule);