Updating .NET products to version 2025.1

In this release, we have focused on implementing long-awaited features that greatly simplify the process of developing templates for reports. Now you can add a report page with a link, asynchronous report preparation with undo support, text rotation with TextRenderType.HtmlParagraph, text search in code editors, export to images for WebReport and much more.

New Opportunities

Adding a report page with a link

In previous releases it was possible to add a page of another report to a report. This option can be found in the "File->Open Page..". By default, a copy of the page is added to the report.

You can now enable the "Add as link" option, which will add a link to the page to the report rather than a copy of the page. This means that when you change a page in the original report, the changes will be reflected in all reports to which the page is added as a link. And vice versa, if a page is changed in one of the reports that has a link to it, it will be changed in the original report as well.

Asynchronous report preparation

Added the report.PrepareAsync() method, enabling asynchronous report preparation in addition to the existing synchronous report.Prepare() method. This method also supports CancellationToken, allowing users to cancel the report preparation process if needed, improving control and performance for large reports in non-blocking environments. This functionality may be further enhanced in the future, with new methods providing additional asynchronous access.

IfNull function

object IfNull(object expression, object defaultValue)

There is a new function allows to avoid System.NullReferenceException when evaluating expressions. The function has two parameters: the first is the expression to be evaluated, the second is the default value. If the expression can be evaluated, the function returns its result. If not, it returns the default value.

Rotate text with TextRenderType.HtmlParagraph

Added support for rotating text with TextRenderType.HtmlParagraph. Previously, text rotation was only available with other text renderer types. You can see examples of text rotation below.

In addition, such texts are now correctly exported to PDF.

Text search in FastReport WPF and FastReport Mono code editors

Now you can search for text not only in FastReport .NET code editor, but also in FastReport WPF and FastReport Mono editors.

An example of searching for text in FastReport WPF code:

And in the FastReport Mono code editor:

Changes in WebReport

Localization support for Blazor WASM WebReport

Introduced localization support for the WebReport interface in FastReport Blazor WebAssembly. Previously, localization was managed through file-based methods, which were incompatible with the WASM environment. A new method, webReport.SetLocalization(Stream) allows loading localization from a Stream, making it compatible with Blazor WASM applications.

Image Export to WebReport

Added export of the report to images. To display it in the list of exports, add the following code:

WebReport.Toolbar.Exports.ShowImageExport = true;

If necessary, you must enable the WebReport option to configure the export to images WebReport.Toolbar.Exports.EnableSettings. After enabling it, you can click on the "gear" and change the settings in the modal window that appears.

Full list of changes

[Engine]
+ added PicturesInParagraph property to RichObject;
+ added method for asynchronous report preparation PrepareAsync();
+ added converting of strings to dbtype compatible;
+ added print scale;
+ added decimal conversion to words in ToWords functions;
+ added locale identifier for Spanish is 22538 (Spanish - Latin America) and 3082 (Spanish - Spain (Modern Sort));
+ a new IfNull function has been added for working with expressions. It returns the result of the calculated expression if it is not null, otherwise the specified default value;
+ implemented calculation of horizontal position of pictures in RichObject;
+ added the ability to send a request in the virtual-host-style;
+ added support for text rotation with TextRenderType = HtmlParagraph;
+ added the ability to use header bands for the "PrintOn" property of the Totals;
* upgraded Oracle.ManagedDataAccess.Core in FastReport.Data.OracleODPCore;
* methods GetConnection, OpenConnection and Dispose marked as virtual;
* added null check for incoming value for Hyperlink.Value property;
* static verification methods TryParse has been introduced into classes of QRCodes;
- fixed text break issues;
- fixed page visibility change after PageStart event;
- fixed conversion to parameter type;
- fixed checking of the report script for stop-words if it contained in the variable name;
- fixed visibility of the bottom border of a text object with enabled GrowToBottom;
- fixed border doubling when the grouped DataBand has the GrowToBottom option;
- removed rendering of child clipPath tags in SVGPictureObject;
- fixed a bug in FinishReport event;
- removed invalid ability to add SubreportObject to ContainerObject;
- fixed changing the CommandType of the request if it was set in GetAdapter;

[Designer]
+ added ability to open page as link from another report;
+ added italic, bold, underline and strikethrough font styles to the span tag;
+ added a search in the TreeView by the character entered from the keyboard;
+ add a search function in the code editors in WPF and Mono;
* added a check for duplicates of downloaded fonts;
* replaced default property values in the constructors of CurrencyFormat, NumberFormat, and PercentFormat classes from fixed values to values from CultureInfo.CurrentCulture;
- fixed incorrect position of Amiri, Cambria Math, DejaVu Math TeX Gyre fonts in the font selection drop-down list;
- fixed a bug leading to System.NullReferenceException when saving borders via Border Editor;
- fixed incorrect display of SVG-images in the designer;
- fixed the display of variables declared in one line on the Code tab in the tooltips;
- fixed page margins length in "ExtraDesignWidth" mode;
- fixed the length of the Guides in the designer for long reports;
- fixed a bug where the selected font was not displayed in the drop-down list;
- fixed incorrect application of data formats;
- fixed an error leading to System.NullReferenceException when deleting a band with a Subreport object;

[Preview]
+ added properties Outline.Expand and Outline.Width in PreviewControl;
- fixed index out of range when previewing empty SvgObject;
- fixed closing of PreviewSearchForm after clicking the "Next" button;

[Exports]
+ added the ability to combine all report pages into one when exporting to Excel;
+ added an option to use a custom format instead of general in Excel-export;
+ added strikethrough text formatting to Word-export;
+ added the MemoryOptimized option for Word-export, which enables the use of FileStream instead of MemoryStream;
+ added support for rotating text with TextRenderType = HtmlParagraph when exporting to PDF;
* format display adjustments - format 'D' and 'MMMM yyyy' are displayed as dates (format 'MM yyyy' if possible), numeric format with negative pattern '-n' is displayed in standard Excel numeric format;
* changed the export of the PictureObject border as an image in Word;
* optimized memory consumption when exporting to PDF;
* changed layout of table export to fixed;
- fixed the issue with HTML tags rendering in HTML export;
- fixed the export of negative PDF property values;
- fixed the color of cell borders in the browser after exporting to Excel;
- fixed border style of cell in Word and PowerPoint;
- fixed export of pictures in header and footer to Word;
- fixed bug with deleting temporary file;
- fixed calculation of line-height when exporting to HTML;
- fixed incorrect export of borders with double line style to PDF;
- fixed a bug with transparency in HTML-Export;
- fixed an issue where the <p> tag was incorrectly displayed during HTML-export;
- fixed default value of "UseHeaderAndFooter" option in Word export;
- fixed incorrect location of images in tabular export to Word;
- fixed the row height of objects sets after TableObject when exporting to Excel;
- fixed NullReferenceException when exporting font to PDF with alternative lookup of substitution;

[WebReport]
+ added the ability to display the report name instead of parameters in the tab;
+ added  SetLocalization method for loading WebReport localization from a Stream;
+ added ability to export report to image format in WebReport;
- fixed inheritance of "box-sizing" from custom application styles in WebReport;
- fixed IndexOutOfRange exception when previewing a WebReport;
- fixed a bug that caused the WebReport.Debug property to not display error information in the report when enabled;
- fixed a bug where a NullReferenceException exception could occur when clicking a tab in WebReport;
- fixed reset AdditionalFilter in WebReport;
- fixed WebReport printing with pages in landscape orientation;

[Online Designer]
+ added a method for updating the table;
- fixed previewing of empty SVG object in Online Designer;

[.NET Core]
+ added methods for MS SQL stored procedures in FastReport Core;

[Common]
+ added a new method for setting an parameter expression via code;
+ added a timestamp when signing installs;

[Extras]
+ added ability of connection to stored procedures in Oracle;
* updated the Firebird.Client version to 10.0.0;
* updated vulnerable packages Npgsql(Postgres) and System.Data.SqlClient;
* changed the text of the error message when pressing the "Advanced" button in the connection to Linter;
- fixed a bug with missing menu in the designer of forms for the Report object;
- fixed a bug with "character varying" type of Postgres;

[Demos]
- fixed demo-report Barcode.frx.