用 C# 为 Excel 添加自动筛选功能

当Excel表格数据量激增时，一个能自动筛选的按钮是非常宝贵的提效工具。

很多前辈可能还在手动设置筛选器，或者依赖复杂的VBA脚本。但对于我们.NET开发者来说，用代码驱动Excel的自动化才是正道。

今天，我就以 `Free Spire.XLS for .NET` 这个库为例，拆解如何用C#为Excel文件添加三种最常用的筛选功能：

• 基础范围筛选
• 按日期分组筛选
• 自定义文本匹配筛选

代码都已经过测试，可以直接拿去用。

核心判断

• `Free Spire.XLS`这个组件很轻量，对Excel 97到2016的格式都支持得很好，而且最关键的是——它免费，还不需要在服务器上安装庞大的Office软件。
• 本文所有基于的测试文件是 `Data.xlsx`，你可以根据实际需求调整路径。

准备工作：安装 Free Spire.XLS

首先，在Visual Studio里创建一个控制台应用。无论是.NET Framework还是.NET Core/.NET 5+都行。

然后通过NuGet包管理器安装它：

NuGet：

Install-Package FreeSpire.XLS

.NET CLI：

dotnet add package FreeSpire.XLS

安装完成后，准备工作就算完成了。下面看具体场景。

1. 基础自动筛选：设定筛选范围

这是最基础也最常用的场景：给指定列的表头添加“下拉箭头”。用户后续可以在Excel里手动点选条件。

代码很简洁，主要就是设置 `AutoFilters.Range` 属性。

using Spire.Xls; namespace AddAutoFilterDemo { class Program { static void Main(string[] args) { // 1. 初始化Workbook并加载Excel文件 using (Workbook workbook = new Workbook()) { workbook.LoadFromFile(@"C:DataData.xlsx"); // 2. 获取第一个工作表 Worksheet sheet = workbook.Worksheets[0]; // 3. 设置自动筛选范围（通常就是表头那行） sheet.AutoFilters.Range = sheet.Range["A1:C1"]; // 4. 保存结果 workbook.Sa veToFile("AutoFilter_Base.xlsx", ExcelVersion.Version2016); } } } }

说明：`AutoFilters.Range`这里只指定了表头行，例如A1:C1。筛选器会自动覆盖该列下方所有的数据行。

保存后打开文件，你就会看到每一列的头部都出现了那个熟悉的筛选按钮。

2. 内置日期筛选：按年月日分组

工作中更常见的一个需求是：如何根据日期字段，快速筛选出某个月、某个季度或某年的数据？

`Free Spire.XLS` 提供了一个非常高效的方法——`AddDateFilter`。它可以按年、月、日、小时、分钟等粒度进行分组过滤。

比如，我们要筛选出 2022年2月 的所有记录：

using Spire.Xls; using Spire.Xls.Core.Spreadsheet.AutoFilter; namespace AddAutoFilterDemo { class Program { static void Main(string[] args) { using (Workbook workbook = new Workbook()) { workbook.LoadFromFile(@"C:DataData.xlsx"); Worksheet sheet = workbook.Worksheets[0]; // 设置筛选范围为 A1:A12（假设A列是日期） sheet.AutoFilters.Range = sheet.Range["A1:A12"]; // 获取待筛选的列（索引0表示第一列） IAutoFilter filterColumn = sheet.AutoFilters[0]; // 添加日期分组：2022年2月 sheet.AutoFilters.AddDateFilter( filterColumn, DateTimeGroupingType.Month, // 按月份分组 2022, // 年份 2, // 月份 0, 0, 0, 0 // 日、时、分、秒（此处不传参） ); // 应用筛选 sheet.AutoFilters.Filter(); workbook.Sa veToFile("AutoFilter_Date.xlsx", ExcelVersion.Version2016); } } } }

要点说明

`DateTimeGroupingType` 枚举非常强大，支持以下类型：

• `Year`
• `Quarter`
• `Month`
• `Day`
• `Hour`
• `Minute`
• `Second`

比如你想筛选2022年第一季度，就把类型设为 `Quarter`，年份为2022，季度参数为1。

这里需要提醒一下：`AutoFilters` 对象不只提供日期筛选，它还支持按 填充颜色 (`AddFillColorFilter`)、字体颜色 (`AddFontColorFilter`)、图标筛选 (`AddIconFilter`) 等。

用法和 `AddDateFilter` 类似，都是先指定筛选列，再传入参数，最后调用 `Filter()` 应用。

本文以日期为例是方便讲解，实际开发中请根据数据类型灵活选用。

3. 自定义筛选：匹配特定文本或数值

有时候，我们需要筛选出包含指定字符串，或等于某个数值的行。这时候 `CustomFilter` 方法就派上用场了。

比如筛选G列中值为 “Grocery” 的所有行：

using Spire.Xls; using Spire.Xls.Core.Spreadsheet.AutoFilter; namespace AddAutoFilterDemo { class Program { static void Main(string[] args) { using (Workbook workbook = new Workbook()) { workbook.LoadFromFile(@"C:DataData.xlsx"); Worksheet sheet = workbook.Worksheets[0]; // 筛选范围为 G1:G12 sheet.AutoFilters.Range = sheet.Range["G1:G12"]; // 获取列对象（需要显式转换为FilterColumn） FilterColumn filterColumn = (FilterColumn)sheet.AutoFilters[0]; // 添加自定义筛选条件：等于 "Grocery" sheet.AutoFilters.CustomFilter( filterColumn, FilterOperatorType.Equal, // 等于操作符 "Grocery" // 比较值 ); // 应用筛选 sheet.AutoFilters.Filter(); workbook.Sa veToFile("AutoFilter_Custom.xlsx", ExcelVersion.Version2016); } } } }

除了 `Equal`，`FilterOperatorType` 还提供了很多选项：

• `LessThan`
• `GreaterThan`
• `Contains`
• `BeginsWith`
• `EndsWith`

这些选项足以应对大部分模糊匹配需求。

如果遇到“包含A或B”这样的组合条件，可以多次调用 `CustomFilter` 并配合逻辑运算符来实现。

进阶技巧与注意事项

• 路径处理：示例用的是绝对路径。实际项目中建议使用相对路径，或者像 `Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Data.xlsx")` 这样从配置读取。
• 性能优化：如果处理的是非常大的Excel文件，可以在加载时使用 `Workbook.LoadFromFile(fileName, ExcelOpenType.Automatic)` 来优化内存。
• 筛选后的数据操作：筛选生效后，如果你想对可见行进行进一步处理，可以遍历 `sheet.Rows` 并检查 `IsHidden` 属性。
• 多列筛选：同时筛选多列时，只需要按顺序为每一列添加条件，最后统一调用一次 `Filter()` 即可。它会自动处理成“与”的关系。
• 清除筛选：如果想一键撤销所有筛选，调用 `sheet.AutoFilters.Clear()` 并重新保存。

总结

通过 `Free Spire.XLS for .NET`，用C#为Excel添加自动筛选功能变得非常直接。

无论是基础的列筛选器、按日期分组，还是自定义文本匹配，它的API都设计得很直观。

本文的三个示例，基本覆盖了最常见的筛选场景。

还有一点值得研究：`AutoFilters` 下的其他方法，比如 `AddDynamicFilter`（动态筛选前N项）和 `AddColorFilter`（按单元格颜色筛选）。

掌握了它们，你的Excel自动化工具箱就更完备了。