Skip to main content

Migrating from Version 3.1

Although every attempt was made to prevent breaking interface changes between versions 3.1 and 3.2, some were inevitable. This topic describes the most notable breaking changes.

Breaking Changes​

  • ActivationGesturesCollection is now a FreezableCollection<ActivationGestures> rather than an ObservableCollection<ActivationGestures>.
  • The CellEditor.TextBoxEditor, CheckBoxEditor, and DatePickerEditor properties are now Frozen meaning that they are read only. The EditTemplate can therefore not be replaced nor modified.
  • ColumnCollection is now an ObservableCollection<ColumnBase> rather than ObservableCollection<Column>.
  • ColumnManagerCell, InsertionCell, StatCell, and DataCell.ParentColumn now return a ColumnBase rather than a Column.
  • CommitItemsEventArgs.CollectionView now returns a DataGridVirtualizingCollectionViewBase rather than a DataGridVirtualizingCollectionView.
  • DataGridCollectionViewSourceBase and DataGridVirtualizingCollectionViewSource.ItemProperties now return an ObservableCollection<DataGridItemPropertyBase> rather than ObservableCollection<DataGridItemProperty>.
  • DataGridContext.ColumnChooserColumns now returns a ReadOnlyObservableCollection<ColumnBase> rather than ReadOnlyObservableCollection<Column>.
  • DataGridContext and DataGridControl.CurrentColumn now return a ColumnBase rather than a Column.
  • DataGridContext, DetailConfiguration, and DataGridControl.VisibleColumns now return a ReadOnlyObservableCollection<ColumnBase> rather than ReadOnlyObservableCollection<Column>.
  • DataGridControl.GlobalCurrentColumn now returns a ColumnBase rather than a Column.
  • DataGridItemPropertyCollection is now an ObservableCollection<DataGridItemPropertyBase> rather than ObservableCollection<DataGridItemProperty>.
  • DataGridVirtualizingCollectionView.PageSize is not an int rather than a double.
  • QueryAutoFilterDistinctValuesEventArgs.ItemProperty now returns a DataGridItemPropertyBase rather than a DataGridItemProperty.
  • Row.CreateCell now requires a ColumnBase rather than a Column.
  • CsvExporter, ExcelExporter, and ExporterBase.EndHeader and StartHeader now require a List<ColumnBase> rather than a List<Column>.
  • When queried, the items in the ItemsSource collection now return a DataRowView rather than a DataRow. (This assumes the datagrid is bound to a DataTable/DataView.)