DataControlBase.AllowLiveDataShaping Property

Gets or sets whether the GridControl recalculates data shaping operations (for example, data sort and filter, summary calculation, and scrollbar annotation display) when you modify a data source outside the grid.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v23.2.Core.dll

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

public bool? AllowLiveDataShaping { get; set; }

VB.NET

Public Property AllowLiveDataShaping As Boolean?

Property Value

Type	Description
Nullable<Boolean>	true to recalculate data shaping operations when you modify a data source outside the grid; otherwise, false.

Remarks

DevExpress GridControl and TreeListControl handle massive data source updates in the same way as the standard DataGrid. Your data classes should implement the INotifyPropertyChanged interface.

The GridControl handles updates only from rows and cells that are visible onscreen. To improve performance, the GridControl does not recalculate data shaping operations as they can take considerable time to complete. If you need to process these operations, set the AllowLiveDataShaping property to true.

Data Shaping Operation Support for Different Data Classes

The following table contains information on support for data shaping operations updates:

	AllowLiveDataShaping = null (default)	AllowLiveDataShaping = false	AllowLiveDataShaping = true
IList
IBindingList (BindingList, DataView)
INotifyCollectionChanged (ObservableCollection)
ICollectionView			[1]
Server Mode

If a data class implements the IBindingList interface, the class processes data shaping operation updates. You can set the AllowLiveDataShaping property to false to disable these updates.

Use the ColumnBase.FieldName property to bind a column to a data field. If you use the ColumnBase.Binding property, the AllowLiveDataShaping property value does not affect data updates.

If your data source class implements the ICollectionView, call the ICollectionView.Refresh method to process data shaping operation updates. If you want to use the AllowLiveDataShaping property, set the AllowCollectionView to false.

If you bind the GridControl to the RealTimeSource class, this class processes data updates, and the AllowLiveDataShaping property has no effect.

Refer to the following topic for information on how to optimize data updates within the GridControl: Frequent Data Updates.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the AllowLiveDataShaping 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.

XAML

wpf-data-grid-process-frequent-data-updates/CS/RefreshDataExample/MainWindow.xaml#L16

<dxg:GridControl AllowLiveDataShaping="False" ItemsSource="{Binding Devices}">
    <dxmvvm:Interaction.Behaviors>

wpf-data-grid-apply-conditional-formatting/CS/ConditionalFormatting/MainWindow.xaml#L13

<Grid>
    <dxg:GridControl Name="grid" ItemsSource="{Binding Path=Items}" AllowLiveDataShaping="True" EnableSmartColumnsGeneration="True">
        <dxg:GridControl.Columns>

how-to-apply-conditional-formatting-in-code-behind-t281415/CS/ConditionalFormatting/MainWindow.xaml#L12

<Grid>
    <dxg:GridControl Name="grid" ItemsSource="{Binding Path=Items}" AllowLiveDataShaping="True" EnableSmartColumnsGeneration="True">
        <dxg:GridControl.Columns>

how-to-use-scrollbar-annotations-t534664/CS/WpfApplication25/MainWindow.xaml#L27

</Grid.ColumnDefinitions>
<dxg:GridControl x:Name="myGrid" AutoGenerateColumns="AddNew" EnableSmartColumnsGeneration="True" ItemsSource="{Binding List}" AllowLiveDataShaping ="True" SelectionMode="Cell" Grid.RowSpan="2">
    <dxg:GridControl.View>

wpf-data-grid-call-begindataupdate-and-enddataupdate-at-view-model-level/CS/BeginEndDataUpdate/MainWindow.xaml#L20

</Grid.RowDefinitions>
<dxg:GridControl ItemsSource="{Binding Source}" AllowLiveDataShaping="True" AutoExpandAllGroups="True" >
    <dxg:GridControl.View>

Footnotes

1. Only if AllowCollectionView is false.