GridControl.AllowLiveDataShaping Property

Gets or sets whether or not the grid recalculates sorting/grouping/filtering/summaries automatically when data in a data source is modified outside the grid.

Namespace: DevExpress.UI.Xaml.Grid

Assembly: DevExpress.UI.Xaml.Grid.v18.2.dll

Declaration

[XtraSerializableProperty]
public bool AllowLiveDataShaping { get; set; }
<XtraSerializableProperty>
Public Property AllowLiveDataShaping As Boolean

Property Value

Type Description
Boolean

true to recalculate sorting/grouping/filtering/summaries automatically when data in a data source is modified outside the grid; otherwise, false.

The grid control handles only updates from rows/cells that are visible onscreen. This significantly improves performance when working with large volumes of data, where only a small number of rows are visible onscreen. However, this makes it impossible to update sorting/grouping/filtering/summary automatically. To force the grid to update sorting/grouping/filtering/summaries, set the AllowLiveDataShaping option to true. Note that in certain instances, this may lead to significant performance degradation when handling an intensive data update flow.

If the grid is bound to an IBindingList data source, all notifications, by default, are handled by the IBindingList implementor, and the sorting/grouping/filtering/summary is automatically recalculated. To disable this behavior, set the AllowLiveDataShaping property to false.

Note

If the grid is bound to ICollectionView, the sorting/grouping/filtering/summary is not updated automatically, regardless of the AllowLiveDataShaping option's state. In this instance, sorting/grouping/filtering is handled by the ICollectionView implementor. To recalculate sorting/grouping/filtering manually, use the ICollectionView.Refresh method.

IList

IBindingList

(BindingList, DataView)

INotifyCollectionChanged

(ObservableCollection)

ICollectionView

INotifyPropertyChanged

AllowLiveDataShaping = null (default)

+ -

+ +

+ -

+ -

INotifyPropertyChanged

AllowLiveDataShaping = false

+ -

+ -

+ -

+ -

INotifyPropertyChanged

AllowLiveDataShaping = true

+ +

+ +

+ +

+ -

No INotifyPropertyChanged

- -

- -

- -

- -

Where:

  • - - Visible rows are not updated; sorting, grouping, filtering and data summaries are not automatically recalculated.
  • - + Visible rows are not updated; sorting, grouping, filtering and data summaries are automatically recalculated.
  • + - Visible rows are updated; sorting, grouping, filtering and data summaries are not automatically recalculated.
  • + + Visible rows are updated; sorting, grouping, filtering and data summaries are automatically recalculated.
Note

Changes in attached properties are not taken into consideration.

See Also