条件筛选

使用 ConditionalDataFilter 来隐藏值不满足一组列规则的行。筛选器针对附加到工作表范围的 ColumnBasedDataSource 工作，并可与其他行筛选器（例如自由文本搜索）组合使用。

前提条件

• 附加一个命名了要筛选的每列的 ColumnBasedDataSource： sheet.AddDataSource(range, dataSource); 如果范围没有数据源或数据源不是基于列的，Worksheet.DoFilter 将抛出异常。
• FilterCondition.ColumnID 中的列 ID 必须存在于 ColumnBasedDataSource.Columns 中；否则在 BeginFilter 期间会引发 ColumnDefineNotFoundException。
• 筛选通过将行高设置为 0 来隐藏行。任何筛选组合都必须调用 Worksheet.DoFilter(range, filter);。

创建和管理规则

ConditionalDataFilter.Conditions 保存活跃的规则。添加或清除项目，并切换 FilterCondition.IsEnabled 来控制哪些规则运行。

using unvell.ReoGrid;
using unvell.ReoGrid.Data;
using unvell.ReoGrid.Data.ConditionFilter;

var sheet = grid.CurrentWorksheet;
var (ds, range) = BuildColumnDataSource();     // 返回 ColumnBasedDataSource 及其范围
sheet.AddDataSource(range, ds);

var filter = new ConditionalDataFilter
{
    ErrorOnMismatchedType = false,             // 如果为 true，在数值/类型不匹配时抛出异常
};

filter.Conditions.AddRange(
    new FilterCondition("price", ConditionOperator.GreaterThan, 1000),
    new FilterCondition("currency", ConditionOperator.Equals, "USD", CellDataKind.Value, ComparisonType.Text),
    new FilterCondition("tradeDate", ConditionOperator.Equals, "2024-05") // 月份级别匹配
);

filter.OnApply += (s, e) => sheet.DoFilter(range, filter);
filter.Apply();                                // 评估规则并隐藏行

关键规则设置

• 运算符（ConditionOperator）：Equals、NotEquals、StartsWith、EndsWith、Contains、NotContains、GreaterThan、EqualsOrGreaterThan、LessThan、EqualsOrLessThan、Includes（数组成员关系）。
• 列：ColumnID 必须匹配数据源列名；ColumnIndex 在 BeginFilter 期间自动分配。
• 值解析（ComparisonType）：默认 Auto 尝试 数值 → 日期时间 → 文本。
  • 数值解析接受数字、字符串、StringBuilder 和百分比（如 "100%"，范围 0.0–1.0）。
  • 日期时间解析接受 DateTime 值和多种字符串格式（yyyy/MM/dd、yyyyMMdd、yyyy-M、yyyy年M月d日、h:m[:s]，以及通用 DateTime.TryParse）。
  • 日期的等值比较遵循从格式推断的 DateTimeValidPart（例如 YYYY、YYYYMM、YYYYMMDD、HHMM、HHMMSS）。
• 比较目标（ComparisonDataKind）：使用 CellDataKind.Value（默认）比较原始值，或使用 CellDataKind.DisplayText 比较格式化文本。示例 UI 在匹配渲染的字符串时将日期列切换为 DisplayText。
• 数组规则：ConditionOperator.Includes 接受任何 IEnumerable；设置 ComparisonType.Numeric 以要求数值成员。
• 空值处理：在等值检查中，空字符串和 null 被视为相等。

单独或组合应用筛选器

当规则变更时调用 Worksheet.DoFilter(range, filter)。一种典型的模式是从筛选器的 OnApply 事件中运行它，这样 UI 变更就会触发重新应用。要与其他筛选器（例如 TextSearchDataFilter）组合，请将它们包装在 MultipleDataFilter 中：

var condition = new ConditionalDataFilter();
var search = new TextSearchDataFilter();
var filters = new MultipleDataFilter();
filters.Filters.Add(condition);
filters.Filters.Add(search);

condition.OnApply += (s, e) => sheet.DoFilter(range, filters);
search.OnApply += (s, e) => sheet.DoFilter(range, filters);

当您更改条件（添加/删除、更新值、切换 IsEnabled）时，调用 Apply() 以触发 OnApply 并重新运行 DoFilter。

API 参考

ConditionalDataFilter

ConditionCollection

FilterCondition

ConditionOperator 枚举

ComparisonType 枚举

CellDataKind 枚举

DateTimeValidPart 枚举

控制日期比较的粒度（从值格式自动推断）：

相关主题

• 数据筛选 — 概述和自定义筛选器
• 内置自动筛选 — Excel 风格的列筛选 UI