报表控件stimulsoft教程：仪表板中过滤器元素的 InclusionMode 属性

翻译|使用教程|编辑：吉炜炜|2025-06-18 14:12:40.860|阅读 3 次

概述：从 2025.2 版本开始，用于仪表板创建的 Stimulsoft 产品引入了InclusionMode属性，我们将在本文中对其进行探讨。

介绍

InclusionMode 属性允许您控制处理关联数据时筛选器的行为。使用此属性可以帮助解决将筛选器应用于聚合数据时出现的细微问题。

仪表板中可能的数据使用场景

让我们考虑一个场景，仪表板使用两个数据源：类别和产品。

如果没有过滤器，产品表将仅显示来自源的实际数据。如果产品数据中的类别数量多于匹配条目数量，则在聚合（例如求和）之后，将出现一行包含产品中没有匹配项的类别的数据。

使用过滤器（例如按类别）时，将向表查询添加与类别列相关的条件。

问题：在过滤器中选择“全部”选项时，包含聚合数据的行会消失，这是不正确的行为。重要！

出现此问题的原因是，连接表的方式多种多样，而选择“全部”选项会触发FULL JOIN机制。您可以阅读了解更多关于连接类型和JoinType属性的信息。InclusionMode属性通过提供两种过滤行为模式解决了这个问题。

过滤模式

让我们看看每种模式是如何工作的：
默认（仅选择）：
仅当选择特定类别时才会激活过滤器。
如果选择“全部”，则过滤器不会添加到查询中→包含聚合数据的行将消失。
始终：即使选择了“全部

”选项，过滤器也始终添加到查询中。在这种情况下，包含聚合数据的行将被保留，因为过滤条件（例如，WHERE CategoryID IS NULL）仍保留在查询中。因此，当即使选择了“全部”也应保留聚合数据（例如总计）时，使用始终值，而当仅在进行明确选择时应用过滤器（例如，用于查询优化）时，使用仅选择。

使用 InclusionMode 属性的优点

- 控制聚合数据当使用带有“全部
”选项的过滤器时，此属性可消除“跳跃”行。 - 可预测性始终模式保证即使选择“全部” ，过滤器也会影响查询。 - 兼容性仅选择模式保留了早期版本用户熟悉的行为。

结论

InclusionMode属性为过滤器管理提供了灵活性，尤其是在处理聚合数据时。使用它有助于防止报表和仪表板中出现意外更改。

---------------------------------------------------------------------------

关于慧都科技：

慧都科技是一家行业数字化解决方案公司，长期专注于软件、油气与制造行业。公司基于深入的业务理解与管理洞察，以系统化的业务建模驱动技术落地，帮助企业实现智能化运营与长期竞争优势。在软件工程领域，我们提供开发控件、研发管理、代码开发、部署运维等软件开发全链路所需的产品，提供正版授权采购、技术选型、个性化维保等服务，帮助客户实现技术合规、降本增效与风险可控。慧都科技是Stimulsoft的在中国区的合作伙伴，Stimulsoft作为图表报表领域的优秀产品，帮助企业实现轻松构建高性能的表格报告及图表。

下载|体验更多Stimulsoft产品，请咨询，或拨打产品热线：023-68661681