如何使用C# NPOI在Excel中设置条件格式IconSet（图标集）

我完全懂你的困扰！想用C# NPOI给Excel单元格加根据值变化的交通灯图标集，却找不到靠谱教程，试了好几种方法都没效果，确实让人头疼。其实NPOI是支持条件格式图标集的，只是相关资料比较零散，下面我就把完整的实现步骤和代码示例分享给你。

核心思路 #

NPOI通过ConditionalFormattingRule和IconSetFormatting类来实现图标集条件格式，我们需要：

• 创建或打开目标Excel工作簿和工作表
• 定义条件格式规则，指定要使用的图标集类型（比如交通灯）
• 设置图标对应的阈值规则（比如数值范围、百分比范围）
• 将规则应用到指定的单元格区域

完整代码示例（以XLSX格式为例） #

using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using NPOI.SS.Util;
using System.IO;

class TrafficLightIconSetDemo
{
    static void Main()
    {
        // 1. 创建新的XLSX工作簿（如果是打开已有文件，替换成FileStream读取即可）
        var workbook = new XSSFWorkbook();
        var sheet = workbook.CreateSheet("数据看板");

        // 2. 填充测试数据，模拟不同数值的单元格
        for (int rowNum = 1; rowNum <= 10; rowNum++)
        {
            var row = sheet.CreateRow(rowNum);
            var cell = row.CreateCell(0);
            // 生成10-100的测试值，方便观察图标变化
            cell.SetCellValue(rowNum * 10);
        }

        // 3. 获取条件格式管理器并创建规则
        var cfSheet = (XSSFConditionalFormattingSheet)sheet;
        var cfRule = (XSSFConditionalFormattingRule)cfSheet.CreateConditionalFormattingRule();

        // 4. 配置图标集：选择交通灯三图标（无边界样式）
        var iconSet = cfRule.CreateIconSetFormatting();
        iconSet.IconSet = IconSet.TRAFFIC_LIGHTS_3;
        // 可选：设置是否显示单元格值，false的话只显示图标
        iconSet.ShowValue = true;

        // 5. 设置图标对应的阈值规则（这里用百分比划分范围）
        // 第一个阈值：≤33%的数值显示红灯
        var thresholdRed = iconSet.CreateThreshold();
        thresholdRed.Type = ConditionType.PERCENT;
        thresholdRed.Value = 33.0;
        thresholdRed.Operator = ComparisonOperator.LE;

        // 第二个阈值：≤66%的数值显示黄灯
        var thresholdYellow = iconSet.CreateThreshold();
        thresholdYellow.Type = ConditionType.PERCENT;
        thresholdYellow.Value = 66.0;
        thresholdYellow.Operator = ComparisonOperator.LE;

        // 第三个阈值默认是>66%，自动显示绿灯，无需额外配置

        // 6. 指定要应用格式的单元格区域（这里是A1到A10）
        var targetRegions = new CellRangeAddress[] { CellRangeAddress.ValueOf("A1:A10") };

        // 7. 将规则应用到目标区域
        cfSheet.AddConditionalFormatting(targetRegions, cfRule);

        // 8. 保存工作簿
        using (var fs = new FileStream("交通灯图标集示例.xlsx", FileMode.Create, FileAccess.Write))
        {
            workbook.Write(fs);
        }
    }
}

关键细节说明 #

• Excel版本兼容：如果是处理旧版XLS格式，只需把代码中的XSSF前缀替换成HSSF（比如HSSFWorkbook、HSSFConditionalFormattingRule）即可
• 图标集类型：NPOI的IconSet枚举提供了很多预设图标，比如ARROWS_3（三箭头）、STARS_3（三星）等，你可以根据需求替换
• 阈值类型：除了示例中的PERCENT（百分比），还支持NUMBER（固定数值）、FORMULA（自定义公式）等类型，比如你可以设置thresholdRed.Type = ConditionType.NUMBER; thresholdRed.Value = 50;来让≤50的单元格显示红灯
• NPOI版本：确保使用的是较新的NPOI版本（比如2.5.3及以上），旧版本可能对条件格式图标集的支持不完善

备注：内容来源于stack exchange，提问作者N.B.R