報表控件stimulsoft教程：儀表板中過濾器元素的 InclusionMode 屬性

翻譯|使用教程|編輯：吉煒煒|2025-06-18 14:12:40.860|閱讀 92 次

概述：從 2025.2 版本開始，用于儀表板創(chuàng)建的 Stimulsoft 產(chǎn)品引入了InclusionMode屬性，我們將在本文中對其進行探討。

相關鏈接：

從 2025.2 版本開始，用于儀表板創(chuàng)建的 Stimulsoft 產(chǎn)品引入了InclusionMode屬性，我們將在本文中對其進行探討。

Stimulsoft Ultimate （原Stimulsoft Reports.Ultimate）是用于創(chuàng)建報表和儀表板的通用工具集。該產(chǎn)品包括用于WinForms、ASP.NET、.NET Core、JavaScript、WPF、PHP、Java和其他環(huán)境的完整工具集。無需比較產(chǎn)品功能，Stimulsoft Ultimate包含了所有內(nèi)容！

Stimulsoft Ultimate 最新版下載

介紹

InclusionMode 屬性允許您控制處理關聯(lián)數(shù)據(jù)時篩選器的行為。使用此屬性可以幫助解決將篩選器應用于聚合數(shù)據(jù)時出現(xiàn)的細微問題。

儀表板中可能的數(shù)據(jù)使用場景

讓我們考慮一個場景，儀表板使用兩個數(shù)據(jù)源：類別和產(chǎn)品。

如果沒有過濾器，產(chǎn)品表將僅顯示來自源的實際數(shù)據(jù)。如果產(chǎn)品數(shù)據(jù)中的類別數(shù)量多于匹配條目數(shù)量，則在聚合（例如求和）之后，將出現(xiàn)一行包含產(chǎn)品中沒有匹配項的類別的數(shù)據(jù)。

使用過濾器（例如按類別）時，將向表查詢添加與類別列相關的條件。

問題：在過濾器中選擇“全部”選項時，包含聚合數(shù)據(jù)的行會消失，這是不正確的行為。重要！

出現(xiàn)此問題的原因是，連接表的方式多種多樣，而選擇“全部”選項會觸發(fā)FULL JOIN機制。您可以閱讀了解更多關于連接類型和JoinType屬性的信息。InclusionMode屬性通過提供兩種過濾行為模式解決了這個問題。

過濾模式

讓我們看看每種模式是如何工作的：
默認（僅選擇）：
僅當選擇特定類別時才會激活過濾器。
如果選擇“全部”，則過濾器不會添加到查詢中→包含聚合數(shù)據(jù)的行將消失。
始終：即使選擇了“全部

”選項，過濾器也始終添加到查詢中。在這種情況下，包含聚合數(shù)據(jù)的行將被保留，因為過濾條件（例如，WHERE CategoryID IS NULL）仍保留在查詢中。因此，當即使選擇了“全部”也應保留聚合數(shù)據(jù)（例如總計）時，使用始終值，而當僅在進行明確選擇時應用過濾器（例如，用于查詢優(yōu)化）時，使用僅選擇。

使用 InclusionMode 屬性的優(yōu)點

- 控制聚合數(shù)據(jù)當使用帶有“全部
”選項的過濾器時，此屬性可消除“跳躍”行。 - 可預測性始終模式保證即使選擇“全部” ，過濾器也會影響查詢。 - 兼容性僅選擇模式保留了早期版本用戶熟悉的行為。

結(jié)論

InclusionMode屬性為過濾器管理提供了靈活性，尤其是在處理聚合數(shù)據(jù)時。使用它有助于防止報表和儀表板中出現(xiàn)意外更改。

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

關于慧都科技：

慧都科技是一家行業(yè)數(shù)字化解決方案公司，長期專注于軟件、油氣與制造行業(yè)。公司基于深入的業(yè)務理解與管理洞察，以系統(tǒng)化的業(yè)務建模驅(qū)動技術落地，幫助企業(yè)實現(xiàn)智能化運營與長期競爭優(yōu)勢。在軟件工程領域，我們提供開發(fā)控件、研發(fā)管理、代碼開發(fā)、部署運維等軟件開發(fā)全鏈路所需的產(chǎn)品，提供正版授權采購、技術選型、個性化維保等服務，幫助客戶實現(xiàn)技術合規(guī)、降本增效與風險可控。慧都科技是Stimulsoft的在中國區(qū)的合作伙伴，Stimulsoft作為圖表報表領域的優(yōu)秀產(chǎn)品，幫助企業(yè)實現(xiàn)輕松構(gòu)建高性能的表格報告及圖表。

下載|體驗更多Stimulsoft產(chǎn)品，請咨詢，或撥打產(chǎn)品熱線：023-68661681