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

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

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

相關鏈接：

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

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

Stimulsoft Ultimate 最新版下載

介紹

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

儀表板中可能的數據使用場景

讓我們考慮一個場景，儀表板使用兩個數據源：類別和產品。

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

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

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

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

過濾模式

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

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

使用 InclusionMode 屬性的優點

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

結論

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

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

關于慧都科技：

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

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