ReevaluateFiltersOnDataChange Property

Specifies whether to re-evaluate record filters when cell data changes. Default is resolved to True.

Syntax

Visual Basic

'Declaration
 
Public Property ReevaluateFiltersOnDataChange As Nullable(Of Boolean)

C#

public Nullable<bool> ReevaluateFiltersOnDataChange {get; set;}

Remarks

By default the data presenter will re-evaluate filters on a record if that record's data changes. It will do so whenever cell data changes, including when data is changed by user input or in code either through the data presenter object model or through the data source directly. To prevent this behavior, you can set ReevaluateFiltersOnDataChange to false. However note that the record filters will get re-evaluated if the filter criteria is modified.

Example

The following code shows some of the properties and methods available to control the behavior regarding when filters are applied to records.

Visual Basic

Imports Infragistics.Windows
Imports Infragistics.Windows.Controls
Imports Infragistics.Windows.Editors
Imports Infragistics.Windows.DataPresenter
Imports Infragistics.Windows.DataPresenter.Events

    Private Sub Window1_Loaded(ByVal sender As Object, ByVal e As RoutedEventArgs)
        
        ' FilterEvaluationTrigger controls when the filters are applied to records 
        ' when the user modifies the filter condition.
        _dp.FieldSettings.FilterEvaluationTrigger = FilterEvaluationTrigger.OnEnterKeyOrLeaveCell

        ' ReevaluateFiltersOnDataChange specifies whether to re-evaluate filters on
        ' a record whose data is changed. Default is true. If you set it to false,
        ' you can manually re-evaluate filters on all records using 
        ' RecordFilterCollection's Refresh method.
        _dp.FieldLayoutSettings.ReevaluateFiltersOnDataChange = False

    End Sub

    Private Sub Button1_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
        ' Typically calling this method is not necessary as the data presenter 
        ' re-evaluates filters on records whenever data changes. However if you 
        ' set the ReevaluateFiltersOnDataChange to false then you can use this 
        ' method to re-filter records.
        _dp.FieldLayouts(0).RecordFilters.Refresh()

        ' You can also re-evaluate filters on a specific data record by calling
        ' its RefreshFilters method.
        _dp.RecordManager.Sorted(0).RefreshFilters()
    End Sub

C#

using Infragistics.Windows;
using Infragistics.Windows.Controls;
using Infragistics.Windows.Editors;
using Infragistics.Windows.DataPresenter;
using Infragistics.Windows.DataPresenter.Events;

		public void Window1_Loaded( object sender, RoutedEventArgs e )
		{
			// FilterEvaluationTrigger controls when the filters are applied to records 
			// when the user modifies the filter condition.
			_dp.FieldSettings.FilterEvaluationTrigger = FilterEvaluationTrigger.OnEnterKeyOrLeaveCell;

			// ReevaluateFiltersOnDataChange specifies whether to re-evaluate filters on
			// a record whose data is changed. Default is true. If you set it to false,
			// you can manually re-evaluate filters on all records using 
			// RecordFilterCollection's Refresh method.
			_dp.FieldLayoutSettings.ReevaluateFiltersOnDataChange = false;
		}

		private void Button1_Click( object sender, RoutedEventArgs e )
		{
			// Typically calling this method is not necessary as the data presenter 
			// re-evaluates filters on records whenever data changes. However if you 
			// set the ReevaluateFiltersOnDataChange to false then you can use this 
			// method to re-filter records.
			_dp.FieldLayouts[0].RecordFilters.Refresh( );

			// You can also re-evaluate filters on a specific data record by calling
			// its RefreshFilters method.
			_dp.RecordManager.Sorted[0].RefreshFilters( );
		}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2