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.)