Backward Compatibility
The following list describes breaking changes introduced in each version and the steps to resolve them when you upgrade.
What Is Different in 2023 R1
Changed
Removed method void Add(T) of SeriesCollectionOfT.
What to Do Now
Use the other overrides of the SeriesCollectionOfT.Add() method.
Changed
The ShapeCollection of the Worksheet is now ChartCollection.
What to Do Now
Use the single ChartCollection.Add() method for adding entries.
What Is Different in 2022 R3
Changed
The parameterless constructors of the following classes are obsolete:
TwoColorScaleValueContextThreeColorScaleValueContextFiveIconSetValueContextFourIconSetValueContextThreeIconSetValueContext
What to Do Now
Use the constructor with parameters instead.
Changed
The UpdateConditionalFormattingCellRanges method is marked obsolete.
What to Do Now
Use the combination of RemoveConditionalFormatting and AddConditionalFormatting instead.
What Is Different in 2022 R2
Changed
The following types are now moved to the namespace Telerik.Windows.Documents.Spreadsheet.Model.ConditionalFormattings:
Telerik.Windows.Documents.Spreadsheet.Model.ConditionalFormattingTelerik.Windows.Documents.Spreadsheet.Model.DataBarAxisPositionTelerik.Windows.Documents.Spreadsheet.Model.PresetIconSetTelerik.Windows.Documents.Spreadsheet.Model.IconDefinition
What to Do Now
Change the full name of the types:
Telerik.Windows.Documents.Spreadsheet.Model.ConditionalFormattings.ConditionalFormattingTelerik.Windows.Documents.Spreadsheet.Model.ConditionalFormattings.DataBarAxisPositionTelerik.Windows.Documents.Spreadsheet.Model.ConditionalFormattings.PresetIconSetTelerik.Windows.Documents.Spreadsheet.Model.ConditionalFormattings.IconDefinition
Changed
IconSetRule.IsReversed is now read-only.
What to Do Now
Set the IsReversed property through the constructor of IconSetRule.
Changed
The Telerik.Windows.Documents.Spreadsheet.Model.FilteredShapeCollection.Changing event arguments type changed from ShapeCollectionChangedEventArgs to ShapeCollectionChangingEventArgs.
What to Do Now
Replace the old event arguments type with the new one.
What Is Different in 2019 R2
Changed
The Values and Categories properties moved from SeriesBase to CategorySeriesBase.
What to Do Now
Use the properties exposed in CategorySeriesBase.
What Is Different in 2019 R1 SP1
Changed
IPdfChartRenderer now uses FloatingChartShape instead of DocumentChart. FloatingChartShape contains UI information for the chart such as Width, Height, Outline, and Fill.
Changed
The method GetBitmapSourceFromChartModel() in ChartModelToImageConverter is deleted.
What to Do Now
Use the GetBitmapSourceFromFloatingChartShape methods, which accept FloatingChartShape instead of DocumentChart. The Export Chart example in the SDK repository shows a possible approach.
What Is Different in 2018 R2
Changed
The default value of Telerik.Windows.Documents.Spreadsheet.Model.Printing.SheetPageSetupBase.PaperType changed from A4 to Letter.
What to Do Now
If you need to keep the document with A4 PaperType, apply this setting before exporting:
Set PaperType
foreach (Worksheet worksheet in workbook.Worksheets)
{
worksheet.WorksheetPageSetup.PaperType = PaperTypes.A4;
}
What Is Different in 2016 R3
Changed
Assemblies with a version number ending with .45 suffix are not distributed.
What to Do Now
Use the assemblies with a version number ending with .40 suffix. The library does not contain code specific for .NET Framework 4.5, so an additional version is not needed.
What Is Different in 2016 Q1
Changed
Telerik.Windows.Maths.dll is removed and integrated in Telerik.Windows.Documents.Spreadsheet.
Changed
Telerik.Windows.Maths.InterpolationExtensions is now internal.
Changed
Telerik.Windows.Maths.RVector is now internal.
Changed
Telerik.Windows.Documents.Spreadsheet.Expressions.Functions.FunctionBase.Evaluate(RadExpression[] arguments) method is obsolete.
What to Do Now
Use Telerik.Windows.Documents.Spreadsheet.Expressions.Functions.FunctionBase.Evaluate(FunctionEvaluationContext context) instead.
Changed
Telerik.Windows.Documents.Spreadsheet.Expressions.Functions.FunctionBase.EvaluateOverride(RadExpression[] arguments) is obsolete.
What to Do Now
Use Telerik.Windows.Documents.Spreadsheet.Expressions.Functions.FunctionBase.EvaluateOverride(FunctionEvaluationContext context) instead.
Changed
Telerik.Windows.Documents.Spreadsheet.Expressions.Functions.FunctionWithArguments.EvaluateOverride(object[] arguments) is obsolete.
What to Do Now
Use Telerik.Windows.Documents.Spreadsheet.Expressions.Functions.FunctionWithArguments.EvaluateOverride(FunctionEvaluationContext<object> context) instead.
Changed
Telerik.Windows.Documents.Spreadsheet.Expressions.Functions.FunctionWithSameTypeArguments<T>.EvaluateOverride(T[] arguments) is obsolete.
What to Do Now
Use Telerik.Windows.Documents.Spreadsheet.Expressions.Functions.FunctionWithSameTypeArguments<T>.EvaluateOverride(FunctionEvaluationContext<T> context) instead.
What Is Different in 2015 Q2
Changed
Telerik.Windows.Documents.Spreadsheet.Layout.Layers.WorksheetRenderUpdateContext.ViewportPaneTypeToVisibleCellBoxes property is removed.
What to Do Now
Use Telerik.Windows.Documents.Spreadsheet.Layout.Layers.WorksheetRenderUpdateContext.VisibleCellLayoutBoxes property instead.
Changed
Telerik.Windows.Documents.Spreadsheet.Measurement.FontManager is removed.
What to Do Now
Use the Telerik.Windows.Documents.Core.Fonts.SystemFontsManager class instead.
Changed
Telerik.Windows.Documents.Spreadsheet.Model.SpreadsheetNameCollectionScope.Name property is removed.
Changed
Telerik.Windows.Documents.Spreadsheet.Model.SelectionState.SelectionState(IEnumerable selectedRanges, CellIndex activeCellIndex) constructor is removed.
Changed
Use Telerik.Windows.Documents.Spreadsheet.Model.SelectionState.SelectionState(IEnumerable selectedRanges, CellIndex activeCellIndex, ViewportPaneType pane) constructor instead.
Changed
Telerik.Windows.Documents.Spreadsheet.Utilities.UnitHelper.EMUsToDIP(int value) is removed.
What to Do Now
Use EmuToDip(double value) method instead.
What Is Different in 2014 Q3
Changed
The default value of the IsEnabled property of the WorkbookHistory class changed to false.
What to Do Now
Enable the history of a Workbook by setting the property to true.
Changed
The Width, Height, and RotationAngle properties of the FloatingShapeBase class no longer update the CellIndex, OffsetX, and OffsetY properties.
What to Do Now
If you need these properties to update automatically, use the SetWidth, SetHeight, and SetRotationAngle methods with the adjustCellIndex parameter set to true.
Changed
The String Name property of SpreadsheetNameCollectionScope is marked obsolete.
What to Do Now
The property is related to the RadSpreadsheet UI control and is not used in the processing library.