DashboardViewer.UseNeutralFilterMode Property

Gets or sets whether to show all items in the filter elements deselected by default.

Namespace: DevExpress.DashboardWin

Assembly: DevExpress.Dashboard.v20.2.Win.dll

NuGet Packages: DevExpress.Win.Dashboard, DevExpress.WindowsDesktop.Win.Dashboard

Declaration

C#

public bool UseNeutralFilterMode { get; set; }

VB.NET

Public Property UseNeutralFilterMode As Boolean

Property Value

Type	Description
Boolean	true to activate Neutral Filter Mode; otherwise, false.

Remarks

The standard filter mode shows all items in the filter elements selected. An extra click is required to begin any actual filtering operation. This is not an optimal implementation for performance reasons, because it generates filtering criteria that are evaluated by the data layer and/or the database.

The neutral filter mode does not apply any criteria to the data source in its default state, resulting in improved performance.

See Neutral Filter Mode to learn more about the neutral filter mode.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the UseNeutralFilterMode property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-dashboard-viewer-neutral-filter-mode/CS/WinForms_NeutralFilterMode_Example/Form1.cs#L19

InitializeComponent();
dashboardViewer1.UseNeutralFilterMode = true;
dashboardViewer1.CustomizeDashboardTitle += DashboardViewer1_CustomizeDashboardTitle;

win-viewer-how-to-apply-default-filtering-to-master-filter-items-that-affect-each-other-t474844/CS/MutualDefaultFiltering/Form1.cs#L23

// Enable or disable the Neutral Filter mode.
dashboardViewer1.UseNeutralFilterMode = true;

how-to-apply-default-filtering-to-master-filters-in-dashboardviewer-t329583/CS/Dashboard_MFDefaultValues/Form1.cs#L10

InitializeComponent();
dashboardViewer1.UseNeutralFilterMode = true;
dashboardViewer1.ConfigureDataConnection += DashboardViewer1_ConfigureDataConnection;

VB.NET

winforms-dashboard-viewer-neutral-filter-mode/VB/WinForms_NeutralFilterMode_Example/Form1.vb#L13

InitializeComponent()
dashboardViewer1.UseNeutralFilterMode = True
AddHandler dashboardViewer1.CustomizeDashboardTitle, AddressOf DashboardViewer1_CustomizeDashboardTitle

win-viewer-how-to-apply-default-filtering-to-master-filter-items-that-affect-each-other-t474844/VB/MutualDefaultFiltering/Form1.vb#L22

' Enable or disable the Neutral Filter mode.
dashboardViewer1.UseNeutralFilterMode = True

how-to-apply-default-filtering-to-master-filters-in-dashboardviewer-t329583/VB/Dashboard_MFDefaultValues/Form1.vb#L12

InitializeComponent()
dashboardViewer1.UseNeutralFilterMode = True
AddHandler dashboardViewer1.ConfigureDataConnection, AddressOf DashboardViewer1_ConfigureDataConnection

Implements

UseNeutralFilterMode