Essential Studio for ASP.NET CORE Release Notes

v25.1.35
March 15, 2024

Common

Features

  • New controls: The following controls have been added in ASP.NET Core.
  • Preview to production-ready controls: The following controls have been developed to meet industry standards and is now marked as production-ready in ASP.NET Core.
  • Syncfusion ASP.NET Core controls are now compliant with Web Content Accessibility Guidelines (WCAG) 2.2 standards.

3D Chart

Breaking Changes

  • Starting from version v25.1.x, the value type of the Animation property in 3D chart series has been changed from object to Chart3DAnimation type.
  • Starting from version v25.1.x, the value type of the Margin and ContainerPadding properties in the 3D chart legend has been changed from object to Chart3DLegendMargin and Chart3DContainerPadding types, respectively.
  • Starting from version v25.1.x, the value type of the Border property in the 3D chart title and subTitle has been changed from object to Chart3DTitleBorder type.
  • Starting from version v25.1.x, the value type of the Location property in 3D chart tooltips has been changed from object to Chart3DLocation type.
  • Now, it’s recommended to enable the enableExport property to activate the export functionality for the 3D chart, allowing users to export it in both JPEG and PNG formats.

3D Circular Chart Preview

The 3D Circular Chart provides a graphical representation of data in three dimensions, with each slice’s size indicating its proportion relative to the entire dataset. Unlike traditional 2D charts, 3D charts add depth to visualization, providing a better understanding of data patterns.

Explore the demo here

Features

  • Series: The 3D Circular Chart can plot pie and donut types.
  • Data binding: Bind the 3D Circular Chart component with an array of JSON objects or a data manager. In addition to chart series, data labels and tooltips can also be bound to the data.
  • Data labels: Annotate points with labels to improve the readability of data.
  • Legends: Provide additional information about points in a customizable and interactive legend.
  • User interaction: Add interactive features such as tooltips, rotation, tilt, data point highlight and selection.
  • Print and Export: Print a 3D Circular Chart directly from the browser and export it in JPEG and PNG formats.
  • RTL: The right-to-left mode aligns tooltips, legends, and data in the 3D Circular Chart component from right to left.

Accordion

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the Angular Accordion component.

AutoComplete

Features

  • #FB6812 - Introducing the object value binding support for the AutoComplete component.
    This feature allows a object of identical fields as the bound dataset, to be assigned to the value property by enabling the objectValueBinding property. You can check out the demo link here.

Button

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the Button component.

Chart

Features

  • #I528518 - Now, it is possible to specify the dasharray for all types of striplines border, including vertical, horizontal, and segmented, in the chart.

CheckBox

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the CheckBox component.

Chip

Features

  • #I422263 - Provided the htmlAttributes support for the Chip component.

ComboBox

Features

  • #FB6812 - Introducing the object value binding support for the ComboBox component.
    This feature allows a object of identical fields as the bound dataset, to be assigned to the value property by enabling the objectValueBinding property. You can check out the demo link here.

ContextMenu

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the ContextMenu component.

Diagram

Features

  • #I524958 - Added support for customizing the style of the main diagram element across multiple selections.
  • #FB50957 - Enhanced BPMN text annotation element with rendering functionality in the symbol palette and diagram, as well as interaction support.
  • #I529065 - Additional keys have been added to our diagram control to improve keyboard interaction.

Bug Fixes

  • #I560179 - Now, setting the ‘isExpanded’ property as false with LineRouting injected will no longer trigger an exception.

Breaking Change

  • Z-Order commands implementation architecture has been enhanced by updating the default zIndex value for node and connector objects from -1 to MIN_VALUE. This improvement ensures dynamic adjustments during zOrder commands like send backward or move forward.

DocIO

Features

  • #I370047, #I515686, #I107555, #I108644, #I116892, #I237097, #I237965, #I257681, #I336732, #F163416 - Now, include \c and \a switches while updating the Table of Contents (TOC) to build table of figures in the Word document.
  • #I565373, #I521060 - Added support to preserve charts with shapes in Word to PDF or image conversion.
  • Added support for wrapped axis titles in charts during Word to PDF or image conversion.
  • Provided support for series line cap formatting in charts during Word to PDF or image conversion.
  • Added support for line dash style formatting in scatter and line charts during Word to PDF or image conversion.
  • Added support for multilevel category labels in charts during Word to PDF or image conversion.
  • Provided support for 100% stacked line charts during Word to PDF or image conversion.
  • Added support for manually positioned chart titles during Word to PDF or image conversion.

DocumentEditor

Features

  • #I560979 - Added the server action settings API for spellcheck by page.
  • #F139237, #I225881, #I238529, F147966, #I251329, #I255850, #I269572, F156967, #I294592, #I308077, #I285839, #I312842, #I315455, #I325461, #I326378, F169367, #I345520, #I348003, #I357490, #I357833, #I357923, #I361570, #I361614, #I364681, #I369799, #I369893, #I370223, #I371589, #I391523 - Added support for collaborative editing. With this feature you can draft and edit Word documents together with multiple users at the same time.
  • #I304171, #I269478, #419821, #I500679 - Added support for heading navigation support.
  • #I317930, #I318103, #I343750, #349393, #F164868 - Added change case functionality allows users to quickly change the capitalization of the selected text.
  • Document Editor now supports saving the document as a Word Template (DOTX).
  • #I458609, #I355736, #I257172, #I348514, #F165825 - Added support to customize color picker in Document Editor.
  • #I264509, #I280374, #I291521, #I327285, #F166016, #F176988 - Added mention support for comments.

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the DropDownButton component.

Features

  • #FB6812 - Introducing the object value binding support for the DropDownList component.
    This feature allows a object of identical fields as the bound dataset, to be assigned to the value property by enabling the objectValueBinding property. You can check out the demo link here.

Bug Fixes

  • #I558972 - The focus from the first item is removed when there are selected items in the Dropdown Tree component.

Features

  • #I322379,#I521440 - The Asp.Net core Dropdown Tree component has been updated to render the popup in the DOM dynamically, significantly improving performance. If you need the popup to render during the initial load, you can set the ‘destroyPopupOnHide’ property to ‘false’.

  • #FB19874 - Provided support for auto check functionality when filtering is enabled in the Dropdown Tree component.

Breaking Changes

  • Now, the default value of enableHtmlSanitizer is true to prevent the XSS attacks in the Angular Dropdown Tree component.

FileManager

Bug Fixes

  • #FB50961 - The issues related to XSS attacks with file or folder names in the File Manager details view template is fixed.

Features

  • Provided support in FileManager component to perform download operations via Fetch API request. Now FileManager component, will allow users to perform download operations using either the default form submit method or the latest Fetch API request with a Boolean property useFormPost in the BeforeDownloadEventargs. The default value of useFormPost is set to true, directing the FileManager component to utilize the form submit method by default for download operations.
  • #I521053 - Custom sorting support is provided in the File Manager component. This feature will allow users to achieve windows natural sorting behaviour using sortComparer property. This is achieved by assigning the ‘sortComparer’ function exported from the utility file.

Gantt Chart

Features

  • #I468621,#I504565,#I518180, #I523106,#I558459 - Provided undo redo support for the actions such as Edit, Add, Delete, Sorting, ColumnReorder, ColumnResize, Search, Filtering, ZoomIn, ZoomOut, ZoomToFit, ColumnState, Indent, Outdent, RowDragAndDrop, TaskbarDragAndDrop, PreviousTimeSpan and NextTimeSpan in Gantt Chart. Please find the demo link here.
  • #I364692 - Provided support for taskbars, task labels, and header templates in the Gantt Chart’s PDF Export feature. Please find the documentation link here.
  • #I522246,#I527511,#I562591- Provided additionalParams API support to customize the Grid and RTE in edit/add dialog. Please find more information here.
  • #I317447,#I323685,#I331269,#I348928,#I349045,#F170155 - Provided multi taskbar support for project view in Gantt Chart where the parent taskbar, when it is collapsed, visually encapsulates the progress of all its child taskbars. Please find the demo link here.

Breaking changes

  • The default value for taskType will be fixedUnit, even when the work field is mapped in taskFields. Previously, if the work field was mapped, its default value internally changed to fixedWork, and resource units were calculated accordingly. Now, it’s necessary to specify taskType as fixedWork at the sample level if the work field is mapped in taskFields.

Grid

Bug fixes

  • #I547583, #I555057 - Fixed the issue where Initial grouping not working with custom data binding in grid.
  • #I550136 - Fixed the accessibility issue associated with the aria-owns property in the Pager component.
  • #I555725 - Resolved issue with horizontal scrolling in grid when both grouping and freeze options are enabled.

Features

  • #I512834 - The autoFitColumns method has been improved to provide more precise adjustments to column widths. This update allows you to adjust column widths based on the maximum content width within a specified range of rows or header content. Additionally, two new optional parameters have been introduced in autoFitColumns- startRowIndex to specify the starting index for content rows and endRowIndex to specify the ending index.
  • #I311297 - The Grid now includes a “show add new row” feature during inline editing. This feature ensures that a blank row is constantly visible within the grid content, facilitating the easy insertion of new records. Explore the demo here.
  • #I280166 - The enhancement of the Grid frozen row and column feature improves compatibility with enabling the row span and column span functionality. Now, you can merge rows and cells when the same value is present within frozen table rows and cells, or within movable table rows and cells. Explore the demo here for spanned row and for spanned column here.
  • #I515873 - When dragging the autofill icon from selected cells to desired cells, the grid now automatically scrolls its content both vertically and horizontally, adjusting according to the direction of your drag.
  • #I335199 - The Grid Infinite scrolling feature enhances the compatibility of the row drag and drop feature.
  • #F47784 - The improvement made to the grid’s infinite scrolling feature enhances its compatibility with the column virtualization functionality. This feature ensures optimal performance by effectively displaying multiple columns within infinite scrolling with large datasets, without experiencing any degradation in performance. Explore the demo here.

Kanban

Bug Fixes

  • #I525892 - Now, the card template works properly upon drag-and-drop action in Kanban with remote data.

  • #I550208 - Now, the swimlane header template will work properly in the mobile view.

Maps

Features

  • #I544447 - Maps will display data labels with improved performance when multiple layers are set.
  • #I524572 - The threshold limit for rendering the markers and marker clusters has now been increased, with improved performance to a decent extent. Nearly 6,000 markers can now be rendered and clustered, with enhanced rendering, zooming, and panning functionalities.
  • The tooltip and its template can now be displayed over the polygon shapes in the Maps. Tooltip templates can include custom items such as images, text, and HTML elements.

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the Menu component.

MultiSelectDropdown

Features

  • #FB46608 - Introducing the virtual scrolling feature for the MultiSelect Dropdown component, it allows users to navigate large lists of options efficiently without the need to load all the items at once. This feature enhances the user experience for applications with long lists of options by enabling the enableVirtualization property. You can check out the demo link here.

  • #FB6812 - Introducing the object value binding support for the MultiSelect Dropdown component. This feature allows objects of identical fields as the bound dataset, to be assigned to the value property by enabling the objectValueBinding property. You can check out the demo link here.

PDF

Features

  • Added support for remote goto actions in PDF documents.
  • Added support to identify and optimize identical resources when merging PDF documents.
  • #I530228 - Added support for image backgrounds in HTML file to image conversion.
  • #I486375 - Added support for creating accessible PDFs when converting from HTML to PDF formats.

Bug Fixes

  • #I554285 - Fixed an issue where sticky note comments were not being saved properly once the PDF was updated.
  • #I556724, #I555734 - Fixed issue where text extracted from a PDF document was not being returned properly.

PDF Viewer

Bug Fixes

  • #I557034 - Now, the text markup content is preserved properly in the exported JSON for multiline annotations.
  • #I559996, #I556643 - Now, the author’s name does not update automatically upon moving the annotations.
  • #I560732 - Now, the empty file is not exported if the added annotations are deleted through the context menu delete option.
  • #I559473 - Now, the exporting rectangle annotation with custom thickness is working properly.

Features

  • #I551138, #I553282 - Implemented functionality to manage PDF page organization, including insertion, deletion, and rotation in the PDF Viewer.
  • #I325358, #I336517, #I355078 - Enabled customization of context menu items in the PDF Viewer by introducing the addCustomMenu API for adding custom menu items. Additionally, provided the customContextMenuSelect and customContextMenuBeforeOpen events to enhance flexibility and control over context menu interactions within the PDF Viewer.
  • #I516224 - Implemented the ability to programmatically control the opening and closing of the bookmark pane in the PDF Viewer through the introduction of the openBookmarkPane and closeBookmarkPane APIs. This allows users to conveniently interact with the bookmark pane within the PDF Viewer interface.
  • #I515986 - Introduced events, namely pageRenderInitiate and pageRenderComplete, in the PDF Viewer to provide notification regarding the initiation and completion of page rendering processes. These events offer users enhanced control and insights into the rendering workflow within the viewer interface.
  • Integrated keyboard accessibility shortcuts and options for custom key commands using the commandManager API in the PDF Viewer, utilizing properties such as keyboardCommand.name for specifying custom command names and keyboardCommand.gesture for defining custom key gestures.
  • #I477482- Enhanced support for rendering custom appearance stamp images in the PDF Viewer.
  • Implemented support for utilizing PNG format images in the Standalone PDF Viewer for adding images to handwritten annotations, custom stamps, signatures, and initial form fields. Previously limited to certain formats like JPEG, now PNG images can also be saved and rendered for these purposes.

Pivot Table

Features

  • #I311046 - Added value sorting support to the OLAP cube connected pivot table, which allows to sort individual measures and their aggregated values in both ascending and descending order using code-behind or UI actions at runtime. Check out the demo here.
  • #I538753 - Done optimization to improve pivot table rendering performance, when there are large number of fields in the bound data source.
  • #I550925 - Added support for selecting fields using node click in the pivot field list UI.
  • Introduced single page mode, which allows only the current view page to be displayed during virtual scrolling operations when virtualization is enabled in the pivot table. It enhances the pivot table’s performance even more during initial rendering and when making UI actions like drill up/down, sorting, filtering, and so on. This is done by rendering only the rows and columns relevant to the current viewport for display in the pivot table. Check out the demo here.

Presentation

Features

  • #I520747, #F176520 - Provided APIs to crop pictures in PowerPoint Presentations, similar to the crop options in Microsoft PowerPoint.
  • #I548180 - Provided an API overload ISlides.Add(ISlide clonedSlide, PasteOptions pasteOptions) to add the cloned slide in the PowerPoint Presentation.
  • #I565373, #I521060 - Added support to preserve charts with shapes in PowerPoint to PDF or image conversion.
  • Added support for wrapped axis titles in charts during PowerPoint to PDF or image conversion.
  • Provided support for series line cap formatting in charts during PowerPoint to PDF or image conversion.
  • Added support for line dash style formatting in scatter and line charts during PowerPoint to PDF or image conversion.
  • Added support for multilevel category labels in charts during PowerPoint to PDF or image conversion.
  • Provided support for 100% stacked line charts during PowerPoint to PDF or image conversion.
  • Added support for manually positioned chart titles during PowerPoint to PDF or image conversion.

ProgressButton

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the ProgressButton component.

QueryBuilder

Features

  • Provided Mongo Query support which helps to get / set the mongo query using the getMongoQuery and setMongoQuery methods in the ASP.NET Core QueryBuilder.

  • Provided the Parameter SQL and Named Parameter SQL support which helps to get the parameter SQL and named parameter SQL queries from the query builder using the getParameterizedSql and getParameterizedNamedSql methods. And set the parameter SQL and named parameter SQL to the query builder using the setParameterizedSql and setParameterizedNamedSql methods in the Asp.NET Core QueryBuilder.

  • Provided the Clone support to query builder which will create an exact replica of a rule or group next to the original using the cloneRule and cloneGroup methods in the ASP.NET Core QueryBuilder.

  • Provided the Lock support which locks all the component in the rule to prevent interaction using the lockRule and lockGroup methods in the ASP.NET Core QueryBuilder.

RadioButton

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the RadioButton component.

Ribbon

Features

  • Gallery item - In addition to the existing built-in items, a new item, gallery, has been added to the Ribbon control. It allows users to perform specific actions by displaying a collection of related items, including icons, content, or images. Check out the demo here.

  • Contextual tabs - The Ribbon control now supports addition of contextual tabs, allows users to display the ribbon tabs on demand based on their needs. Similar to the normal ribbon tabs, it supports adding all built-in and custom ribbon items to execute specific actions. Check out the demo here.

  • KeyTips support - The KeyTips feature enables users to quickly access the tabs or ribbon items by using defined unique key tips (up to 3 characters). To show the KeyTips, press Alt + Windows/Command keys, and close or traverse back by pressing the Esc key. Check out the demo here.

Rich Text Editor

Bug fixes

  • The smoothness and performance of table cell resizing have improved.

  • Improved the image resize function to keep the aspect ratio when resizing.

  • When Quick Toolbar is active, press Alt + F10 to focus on Quick Toolbar items.

  • #I51118 - Now, the pasted content with the picture element will have proper source values.

  • #I555698 - Now, the customized text is shown properly in the numberFormatList icon’s tooltip in the Rich Text Editor.

  • #I561056 - Now, the font color is applied properly to the hyperlink text when clicking the fontcolor icon in Rich Text Editor.

  • #I548243 - Now, pressing the enter key in the Rich Text Editor will scroll the page properly, with the height property set to auto in iframe mode.

Schedule

Features

  • #I511506 - Provided support to prevent the reloading of appointment data source when resource data source changes dynamically by providing an additional boolean parameter isEventDataRefresh in the setResourceCollections method. To prevent reloading of the appointments you have to send the isEventDataRefresh parameter value as false.

Slider

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the Slider component.

SplitButton

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the SplitButton component.

Spreadsheet

Features

  • #I369726 - Now, provided support for accepting the culture-based argument separator in the formula.
  • #I369726 - Now, provided support to pass numeric values with culture-based decimal separators as arguments to the formulas.

Stepper

Bug fixes

  • #I564429 - The issue with stepper progress bar misalignment in firefox browser has been resolved.

Tab

Bug fixes

  • #I523384 - The issue with the active tab background color has been resolved.

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the Tab component.

TextArea Preview

The TextArea is a fundamental input element in web development that allows users to input multiple lines of text within a specific area, such as comments, messages, composing detailed notes, or other lengthy content. This control is an enhanced version of the HTML text area element with additional features.

Explore the demo here

Features

  • Resizable: The TextArea can be resized vertically, horizontally, or in both directions by selecting the corresponding ‘ResizeMode’ option. Please find the demo here.
  • Row-Column configurations: Configure the size and appearance of the textarea element in terms of rows and columns to suit specific design and functionality requirements. Please find the demo here.
  • Floating label: The TextArea intelligently floats the placeholder text based on the specified ‘FloatLabelType’ option, providing users with clear guidance and enhancing usability. Please find the demo here.

Timeline Preview

The Timeline control enables users to display a series of data in chronological order, providing a visually compelling and user-friendly experience. This showcases user activities, tracking progress, narrating historical timelines, and more.

Explore the demo here

Features

  • Orientation - Display items in a horizontal or vertical orientation.
  • Opposite content - Display additional information opposite to the item content.
  • Items alignment - Items’ content and opposite content can be aligned - before, after, alternate, or alternate reverse.
  • Reverse timeline - Shows the timeline items in the reverse order.
  • Templates - Customize the default appearance, including styling the dot item, templated content, and more.

Tooltip

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the Tooltip component.

TreeView

Breaking Changes

  • Now, the default value of enableHtmlSanitizer property is true to prevent the XSS attacks in the TreeView component.

Visual Studio Extensions

Breaking Changes

  • Support for .NET 5.0 templates in “ASP.NET Core Extensions” will be discontinued.

  • ASP.NET Core extensions will no longer be supported in Visual Studio 2019.

XlsIO

Features

  • Provided support for wrapped axis titles in chart to image conversion.
  • Provided support for series line cap formatting in chart to image conversion.
  • Provided support for line dash style formatting in scatter and line charts in chart to image conversion.
  • Provided support for multilevel category labels in chart to image conversion.
  • Provided support for 100% stacked line chart in chart to image conversion.
  • Provided support for manually positioned chart titles in chart to image conversion.

Bug Fixes

  • #I552205 - Dotted lines are not rendered properly issue is fixed in the chart to image conversion.
  • Argument out-of-range exception thrown when resaving the Excel file in Thai culture is fixed.