Dropped Microsoft Visual Studio 2015 Support |
ActiveReports 16 is not supported in Microsoft Visual Studio 2015. |
Dropped Internet Explorer 11 Support |
ActiveReports 16 no longer supports Internet Explorer 11 owing to the Microsoft announcement. |
The Web package no longer includes a dependency from the Web.Design package |
For using the WebViewer control in the ASP.NET Designer, you need to install an additional GrapeCity.ActiveReports.Web.Design (or GrapeCity.ActiveReports.Web.Design.VS2022) package that corresponds to the Visual Studio version you are using. Installing the GrapeCity.ActiveReports.Web package does not install the Web Design package, thus you may see some design time or compilation errors. |
Extended IRenderingExtension with a cancellation token |
If you implemented a custom rendering extension, it needs to be updated with the implementation of the new Render Signature. Use IRenderingExtension as follows: |
Now the -out path in the console for importing reports supports only a folder path |
Previously, while using the Import tool via command line, you could use -out to specify a path to a file or a path to a folder. Now, -out specifies the path to a folder only. |
Scripts with WinForms dependencies will no longer work |
You may need to load WinForms dependencies manually by using code similar to the following.
var rpt = new SectionReport();
public void detail_Format() { |
PDF export settings in ASP.NET WebForms viewer |
If you specified export settings on the ASPX page, it may require some updates due to this breaking change. |
Breaking changes from ActiveReports 14 to ActiveReports 15
StreamProvider Changes |
The StreamProvider class and the related classes have been moved from GrapeCity.ActiveReports.Core.Rendering.dll to GrapeCity.ActiveReports.dll. The following public classes have been moved (namespaces have not been changed):
|
Rdf Rendering Extension Changes |
In earlier versions of ActiveReports, all export assemblies depended on the Rdf rendering extension assembly to add corresponding export methods to export filters. With .NET 4.6.2, we have implemented extension methods and removed the IDocumentExportEx interface. So, if the you want to export an RDLX file to RDF, using the export filter, you can manually add a dependency from the Rdf rendering extension NuGet package and use IDocumentExport instead of IDocumentExportEx. |
Dropped Microsoft Visual Studio 2013 Support |
ActiveReports 15 is not supported in Microsoft Visual Studio 2013. |
Improved WebViewer |
|
Improved Web Designer |
|
RDL report changes |
|
System.Text.Json now replaces Newtonsoft.Json |
This change has affected the Json data provider. Note that System.Text.Json validates json more strictly, so some non-valid json might work in Newtonsoft.Json but won't work in System.Text.Json. |
Migration to DataEngine 3.0 |
In DataEngine 3.0, the Gcef.Data.DataEngine, Gcef.Data.ExpressionInfo, and Gcef.Data.VbFunctionLib assemblies have been updated to match the assembly names and not clash. The root namespace in Gcef.Data.ExpressionInfo has been changed from GrapeCity.Enterprise.Data.DataEngine to GrapeCity.Enterprise.Data.Expressions. If you use the ExpressionInfo class directly, you must add the 'using GrapeCity.Enterprise.Data.Expressions;' directive to your files. |
GrapeCity.ActiveReports.Chart assembly has been split |
The Chart assembly and the NuGet package have been split into 2 assemblies and 2 NuGet packages.
|
GrapeCity.ActiveReports.Document assembly has been split |
The GrapeCity.ActiveReports.Document assembly has been split into four assemblies:
|
ASP.NET Core now renders a section report |
Now you can use a section report with an ASP.NET Core with GcDoc based rendering. |
Some common functions have been extracted from WinForms and WPF Viewers |
Now you should reference Viewer.Common if you need to use printing. |
CopyToClipboard method has been moved from SectionDocument to the Engine extension |
Now you should reference the GrapeCity.ActiveReports package (Export.Word and Export.Xml) to use this method. |
GDI text metrics provider has been dropped |
ActiveReports 13-like GDI/GDI+ text metrics have been dropped from AR.Core (as we use only GcDoc text metrics provider since ActiveReports 14). |
SafeGraphics class has been removed |
The SafeGraphics utility internal class has been dropped. Please update the related code in ActiveReports samples that used this class. |
Migration to GrapeCity.DataVisualization.Chart 0.3.* |
|
Printer/PrintOptions have been dropped from PageDocument for .NET Core 3.1 and .NET 5.0 |
Added overload for the PageDocument.Print method to pass printer (with settings). You need to rewrite the code if you are using this in your projects. |
DoEvents are no more called by the Section report's Run() method |
To achieve the legacy behavior, use rpt.Run(true). |
Breaking changes from ActiveReports 13 to ActiveReports 14
Installer |
Simplified installation
Assemblies moved to NuGet - https://www.nuget.org/packages/
JSViewer and Web Designer are now available on NPM - https://www.npmjs.com/package/ Samples are moved to GitHub - https://github.com/activereports/ |
Removed HTML5Viewer |
You should now use the improved JSViewer (available with Professional Edition). |
Improved WebViewer |
Changed UI of Html mode since we are using the new JSViewer internally. ReportService settings in web.config (ActiveReportsXX section) are ignored. Moved ReportsFolder property to the WebViewer control properties. Changed WebViewer component API
The WebViewer and JSViewer are supported only in the Integrated pipeline mode. You will get PlatformNotSupportedException on using these Viewers in Classic pipeline mode. |
Dropped Oracle Data Provider |
The Oracle data provider is no more available since System.Data.OracleClient is deprecated. If you want, you can still add this data provider to your application. The sample OracleDataProvider elaborates how to do that. |
Modified Text Rendering |
The text align is changed from Left to Center in last row of paragraph, if the last row contains only one character, and if the following properties are set: TextAlign = Justify and TextJustify=DistributeAllLines. This change can be observed in designer, preview, and PDF, Word, Excel, and Image exports. |
Changed PdfRenderingExtension (RDL reports) |
PDF export dialog
API
|
Changed SVG Rendering extension |
Removed internal assembly GrapeCity.ActiveReports.Export.Svg. Now, GrapeCity.ActiveReports.Core.Export.Svg.Page assembly is used internally to export complex report items such as charts, map, etc. to HTML as SVG content. |
Changed ImageRenderingExtension |
|
Removed following assemblies |
GrapeCity.ActiveReports.Core.Diagnostics.dll |
RdfRenderingExtension |
RdfRenderingExtension is now obsolete. |
1Use SetLocateDataSource method of the report service instead, as shown:
Copy Code
|
|
---|---|
Application_Start(object sender, EventArgs e) { this.UseReporting(settings => |
Also, you can set the LocateDataSource event handler for a report directly as in the following code example.
Copy Code
|
|
---|---|
pageReport.Document.LocateDataSource += new LocateDataSourceEventHandler(Document_LocateDataSource); webViewer.Report = pageReport; |
Breaking changes from ActiveReports 12 to ActiveReports 13
Class/Namespace | ActiveReports 12 | ActiveReports 13 | Impact |
---|---|---|---|
ResourceLocator, DefaultResourceLocator | GrapeCity.ActiveReports.Extensibility.v12 | GrapeCity.ActiveReports.Core.Rdl | On creating own resource locator |
GrapeCity.ActiveReports.PageReportModel.* | GrapeCity.ActiveReports.v12 | GrapeCity.ActiveReports.Core.Rdl | On creating reports dynamically |
GrapeCity.ActiveReports.Rendering.IO.* | GrapeCity.ActiveReports.v12 | GrapeCity.ActiveReports.Core.Rendering | On rendering to any rendering extension |
GrapeCity.ActiveReports.Extensibility.Rendering.Components.* | GrapeCity.ActiveReports.Extensibility.v12 | GrapeCity.ActiveReports.Core.Rendering | On creating own rendering extensions or custom report items |
GrapeCity.ActiveReports.Extensibility.Data.* | GrapeCity.ActiveReports.Extensibility.v12 | - | On using own data providers |
GrapeCity.ActiveReports.Dashboard.* | GrapeCity.ActiveReports.Dashboard.v12 | GrapeCity.ActiveReports.Core.Rendering | - |
GrapeCity.ActiveReports.Calendar.* | GrapeCity.ActiveReports.Calendar.v12 | Calendar is moved to samples | - |
GrapeCity.ActiveReports.Extensibility.Rendering.IRenderingExtension | GrapeCity.ActiveReports.Extensibility.v12 | GrapeCity.ActiveReports | On creating own rendering extensions |
GrapeCity.ActiveReports.ReportData.DataProviders.* | GrapeCity.ActiveReports.v12 | GrapeCity.ActiveReports.Core.DataProviders | On using CSV, JSON, Object, Xml, DataSet data providers |
GrapeCity.ActiveReports.ArsClient.* | GrapeCity.ActiveReports.ArsClient.v12 | removed | - |
GrapeCity.ActiveReports.OracleClient.* | GrapeCity.ActiveReports.OracleClient.v12 | GrapeCity.ActiveReports.Core.DataProviders | - |
ActiveReports 12 approach | ActiveReports 13 approach |
|
|
Breaking changes from ActiveReports 11 to ActiveReports 12
=Theme.Constants("Name") & " - " & [OrderDate].Year
are now evaluated as 'render time' expressions.Breaking changes from Previous ActiveReports versions to ActiveReports 12
The Excel Transformation Device option, the File menu item Microsoft Excel WorkSheet - Data (XLS), is no longer available for RDL reports in the default export dialogs of the viewer and designer applications shipped with the product. For backward compatibility, the Excel Transformation Device API is still available, but it does not support the new Tablix control. In order to successfully export reports using the new Tablix control, please use the Excel Rendering Extension option, the File menu item Microsoft Excel WorkSheet - Layout (XLS, XLSX).
The Matrix data region has been replaced in the toolbox with the new Tablix data region. However, it is still available in the API for backward compatibility.
The OleObject control is now hidden by default in the toolbox for Section reports. To show this control in Visual Studio, open the GrapeCity.ActiveReports.config file and change the EnableOleObject value to true, and include this file with your application. You can find this file here: C:\Program Files (x86)\Common Files\GrapeCity\ActiveReports 12
.
To show the OleObject control in the Designer control in your own end users designer applications, select the Designer control and, in the Properties window, change the EnableOleObject property to True.
The WebViewer control is now AJAX-based, and requires ActiveReports.ReportService.asmx to be in the root of the Web site or Web application. This is added automatically when you drop a WebViewer control on a Web form, or you can add it from the Add New Item dialog by selecting ActiveReports 12 Web Service, or manually by copying it from C:\Program Files (x86)\Common Files\GrapeCity\ActiveReports 12. ExceptionOccurring, QueuingReport, ReportCreating and ReportDisposing events are no longer available in WebViewer class.
The Viewer control no longer has Annotations turned on by default. To enable Annotations, set the AnnotationDropDownVisible property of the Viewer control to True. DataDynamics.ActiveReports.Viewer.ReportViewer.MultiplePageMode property is now integrated into ViewType property of Viewer class. Viewer.ReportViewer.PaperColor property has been removed. Viewer.PageOffset property's type has been changed from Integer to System.Drawing.Point.
The Toolbar is now a Windows ToolStrip. Please see the MSDN ToolStrip Class for more information.
In RDL and Page reports, the default behavior of the Series Border Style setting for Area, Pie and Doughnut chart types has been changed. Now, the default value of this setting is None, thus no style formatting is applied.
Rendering Extensions (Image): ColorDepth is an obsolete property of GrapeCity.ActiveReports.Export.Image.Page.Settings class.
Expressions: In Page report and RDL report expressions, "True" and "False" values are now handled as String, and not as Boolean values.
For example, =IIF(Fields!FieldName.Value = "True", 1, 0)
is now an invalid expression when FieldName.Value returns a Boolean value, instead, use =IIF(Fields!FieldName.Value = True, 1, 0)
expression.
In ActiveReports 12, some classes have been moved to different namespaces from previous versions of ActiveReports and Data Dynamics Reports. Drop down the table below to see some of the most commonly used classes that are in new namespaces.
Some of the changes that are not picked up by the upgrade tool may cause some issues in your code. The two most frequently encountered changes are:
These are all of the assemblies and namespaces that have changed, with any major changes noted.
ActiveReports is now GrapeCity.ActiveReports.v12
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports |
|
DataDynamics.ActiveReports.DataSources | GrapeCity.ActiveReports.Data |
DataDynamics.ActiveReports.Interop | GrapeCity.ActiveReports |
DataDynamics.ActiveReports.Options | GrapeCity.ActiveReports.SectionReportModel |
ActiveReports.Chart is now GrapeCity.ActiveReports.Chart.v12
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports.Chart | GrapeCity.ActiveReports.Chart |
DataDynamics.ActiveReports.Chart.Annotations | GrapeCity.ActiveReports.Chart.Annotations |
DataDynamics.ActiveReports.Chart.Graphics | GrapeCity.ActiveReports.Chart.Graphics |
ActiveReports.Design is now GrapeCity.ActiveReports.Design.Win.v12
The Report property is now an Object that gets or sets a GrapeCity.ActiveReports.Document.SectionDocument or GrapeCity.ActiveReports.Document.PageDocument.
The ColorTheme property of the Designer class is deprecated.
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports.Design | GrapeCity.ActiveReports.Design |
DataDynamics.ActiveReports.Design.ReportExplorer | GrapeCity.ActiveReports.ReportExplorer |
DataDynamics.ActiveReports.Design.Toolbox | GrapeCity.ActiveReports.Design.Toolbox |
ActiveReports.Document is now GrapeCity.ActiveReports.Document.v12
The Document class is now called SectionDocument.
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports | GrapeCity.ActiveReports |
DataDynamics.ActiveReports.Document |
|
DataDynamics.ActiveReports.Export | GrapeCity.ActiveReports.Export |
DataDynamics.ActiveReports.Export.Html | GrapeCity.ActiveReports.Export.Html |
DataDynamics.ActiveReports.Document.Annotations | GrapeCity.ActiveReports.Document.Section.Annotations |
ActiveReports.HtmlExport is now GrapeCity.ActiveReports.Export.Html.v12
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports.Export.Html | GrapeCity.ActiveReports.Export.Html.Section |
ActiveReports.PdfExport is now GrapeCity.ActiveReports.Export.Pdf.v12
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports.Export.Pdf | GrapeCity.ActiveReports.Export.Pdf.Section |
DataDynamics.ActiveReports.Export.Pdf.Signing | GrapeCity.ActiveReports.Export.Pdf.Section.Signing |
ActiveReports.RtfExport is now GrapeCity.ActiveReports.Export.Word.v12
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports.Export.Rtf | GrapeCity.ActiveReports.Export.Word.Section |
ActiveReports.Silverlight is now GrapeCity.ActiveReports.Viewer.Silverlight.v12
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports | GrapeCity.ActiveReports |
ActiveReports.TextExport is now GrapeCity.ActiveReports.Export.Xml.v12
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports.Export.Text | GrapeCity.ActiveReports.Export.Xml.Section |
ActiveReports.TiffExport is now GrapeCity.ActiveReports.Export.Image.v12
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReportsExport.Tiff | GrapeCity.ActiveReports.Export.Image.Tiff.Section |
ActiveReports.Viewer is now GrapeCity.ActiveReports.Viewer.Win.v12
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports.Toolbar | The viewer now uses Visual Studio ToolStrips. Please see MSDN ToolStrip Class for more information. |
DataDynamics.ActiveReports.Viewer |
|
ActiveReports.Web is now GrapeCity.ActiveReports.Web.v12
The Report property is now an Object that gets or sets a SectionDocument or ReportDocument.
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports.Web | GrapeCity.ActiveReports.Web |
DataDynamics.ActiveReports.Web.Controls | GrapeCity.ActiveReports.Web.Controls |
DataDynamics.ActiveReports.Web.ExportOptions | GrapeCity.ActiveReports.Web.ExportOptions |
DataDynamics.ActiveReports.Web.Handlers | GrapeCity.ActiveReports.Web.Handlers |
ActiveReports.XlsExport is now GrapeCity.ActiveReports.Export.Excel.v12
ActiveReports Namespace (previous versions) | ActiveReports 12 Namespace |
---|---|
DataDynamics.ActiveReports.Export.Xls | GrapeCity.ActiveReports.Export.Excel.Section |
DataDynamics.SpreadBuilder | GrapeCity.SpreadBuilder |
DataDynamics.SpreadBuilder.Cells | GrapeCity.SpreadBuilder.Cells |
DataDynamics.SpreadBuilder.Imaging | GrapeCity.SpreadBuilder.Imaging |
DataDynamics.SpreadBuilder.Printing | GrapeCity.SpreadBuilder.Printing |
DataDynamics.SpreadBuilder.Style | GrapeCity.SpreadBuilder.Style |