Essential Studio for ASP.NET CORE Release Notes

Common

Features

  • Syncfusion ASP.NET Core controls are now compatible with latest .NET 10 preview versions.
  • Block Editor control has been added newly in Syncfusion ASP.NET Core Library.
  • Speech To Text control has been developed to meet industry standards and is now marked as production-ready in ASP.NET Core.

Breaking Changes

  • Below TargetFrameWork’s dependent packages version have been upgraded to resolve the vulnerability issues.
    • TargetFramework .NET Standard 2.0:
      • Microsoft.AspNetCore.Mvc upgraded from 2.1.3 to 2.3.0.
      • Microsoft.AspNetCore.Mvc.Core upgraded from 2.2.5 to 2.3.0.
      • Newtonsoft.Json upgraded from 13.0.2 to 13.0.3.
      • System.Text.Encodings.Web upgraded from 4.5.1 to 9.0.4.
    • TargetFramework .NET Standard 2.1:
      • Microsoft.AspNetCore.Mvc upgraded from 2.1.3 to 2.3.0.
      • Microsoft.AspNetCore.Mvc.Core upgraded from 2.2.5 to 2.3.0.
      • Newtonsoft.Json upgraded from 13.0.2 to 13.0.3.
      • System.Text.Encodings.Web upgraded from 4.5.1 to 9.0.4.
    • TargetFramework .NET 8.0 and .NET 9.0:
      • Newtonsoft.Json upgraded from 13.0.2 to 13.0.3.

Breaking Changes

  • The value type of the emptyPointMode property has been updated from AccEmptyPointMode to the EmptyPointMode enum to define the proper empty point mode.

AI AssistView

Features

  • Now the AI Assistview supports div based text input instead of traditional textarea, offering a more intuitive and flexible user experience for prompt entry.

  • Now we have provided attachment support in the AI AssistView, enabling users to attach files to their prompts for enhanced AI interactions. This functionality is controlled using the enableAttachments property and can be further customized through the e-aiassistview-attachmentsettings tag helper.

  • Additionally, the following events have newly been added to provide control over the attachments:

    • beforeAttachmentUpload: Triggered before the attached file upload begins.

    • attachmentUploadSuccess: Triggered when the attached file is successfully uploaded.

    • attachmentUploadFailure: Triggered when the attached file upload fails.

    • attachmentRemoved: Triggered when an attached file is removed.

Explore the demohere

Block Editor preview

The ASP.NET Core Block Editor is a modern, block-based content editing solution for web applications. It provides an intuitive and flexible interface for creating rich, structured documents using interactive content blocks.

Explore the demo here
Explore the documentation here

Features

  • Multiple block types: Heading levels 1-4, paragraphs, lists, checklists, quotes, callouts, dividers, code blocks, and more.
  • Slash commands: Interactive / commands to insert or transform content blocks efficiently.
  • Drag and drop: Reorder blocks effortlessly with built-in drag-and-drop support.
  • Action menu: Perform block-level operations such as move, delete, and duplicate.
  • Contextmenu support: Right-click context menus for quick block actions.
  • Inline content support: Insert inline elements like links, labels, and mentions directly within blocks
  • Undo/Redo operations: Undo and redo support for the user interactions.

Chart

Features

  • Added support to highlight the last value of the series with a label and grid line indicator, offering a clear and immediate reference point for the series endpoint. Explore the demo here

Breaking Changes

  • The value type of the emptyPointMode property has been updated from object to the EmptyPointMode enum to define the proper empty point mode.

Chat UI

Features

  • Now the Chat UI supports div based text input instead of traditional textarea, offering a more intuitive and flexible user experience for prompt entry.

  • Now we have provided support for displaying user status icons in the Chat UI, by using the statusIconCss property, allowing visual representation of user presence.

  • Chat UI now supports the compact mode by using the enableCompactMode property to align all messages to the left, creating a cleaner layout ideal for group chats and compact displays.

  • Now we have provided support for message options in the Chat UI component, including new properties like isPinned, replyTo, and isForwarded in the message model to enable pinning, replying, and forwarding functionalities. Which can be further customized using the messageToolbarSettings property, which by default includes actions like Copy, Reply, Pin, and Delete for a richer chat experience.

Explore the demo here

DateRangePicker

Features

  • The DateRangePicker allows users to input date values in various valid formats, enhancing the user experience by offering flexibility in specifying date formats for parsing. A new API called inputFormats has been introduced to handle custom date input formats, allowing users to specify the expected format(s) for parsing date and time values. For example, InputFormats='new string[] { "dd/MM/yyyy - dd/MM/yyyy", "MM/dd/yyyy - MM/dd/yyyy", "yyyy-MM-dd - yyyy-MM-dd" }'. Please find the demo link here.

Diagram

Features

  • Container Object Support: Added support for creating container objects to logically group related shapes, either programmatically or through the visual interface using built-in Container shapes. This feature enhances organization and structure within complex diagrams. See the demo for more details.

  • Automatic Generation of UML Sequence Diagrams from Model Data: Added support to automatically generate UML sequence diagrams using the UMLSequenceDiagramModel. This feature dynamically creates lifelines, messages, and activation boxes based on the provided model data—reducing manual effort and improving accuracy. See the demo for more details.

  • Interactive Port Management: Added support for interactively adding and removing ports on nodes and connectors. Newly created ports can also immediately initiate connections, enabling faster and more intuitive diagram construction.

  • Negative Axis Restriction: Introduced an option to restrict dragging or dropping of diagram elements into the negative axis area. This provides better control over layout boundaries and ensures consistent element positioning.

DocIO

Features

  • #I84570, #I149806, #I73532, #I104716, #I105049, #I109548, #I119864, #I124725, #I130014, #I137039, #I137196, #I323992, F165479, F168737, #I652765, #I658111 - Provided support to create and remove editable ranges in protected DOCX format documents.
  • #I635778, #I214139, #I665210, #I624912, #I583370, #F141869, #FB26929 - Added support to create list number formats including Arabic, Hebrew, Chinese, and Thai in DOCX format documents and preserve them during Word-to-PDF and image conversions.
  • #I376950, #I411898, #I465126, #I679498, #I297755, #I301645, #I307279, #I349118, #I176036, #I184228, #I216695, #I331649, #I680106, #I86205, #I107655, #I182993, #I201718, #I209411, #I225246, #I311779, #I317812, #I345122 - Added support to preserve shape fill formats such as gradients, transparency, and pattern fills during Word-to-PDF and image conversions.
  • #I70284, #I144361, #I160658, #I188244, #I201718, #I202261, #I206374, #I212424, #F137571 - Recolor effects like grayscale, sepia, and color tone adjustments are now preserved during Word-to-PDF and image conversions.
  • #I293751, #I310315, #I337547, #I367467, #I469762, #I496627, #I650620, #F176420 - Drawing canvas and its contents are now preserved when converting Word documents to PDFs and images.
  • Font substitution is now supported inside charts, allowing users to configure fallback fonts when the original fonts are unavailable during Word to PDF and image conversions.
  • Provided fallback font support for Unicode characters in charts to preserve multilingual content during Word-to-PDF and image conversions.
  • Improved preservation of EMF and WMF metafile images as searchable content during Word-to-PDF conversions.

Breaking Changes

  • Changed the assemblies name of “Syncfusion.MetafileRenderer.NET.dll” into “Syncfusion.MetafileRenderer.Portable.dll” in the build and NuGet package.
  • Added the assembly of “Syncfusion.PDF.Portable.dll” as a dependency of “Syncfusion.MetafileRenderer.Portable.dll” in the build and NuGet package.

File Manager

Features

  • Added support for authorization headers in image retrieval: Custom authorization headers can now be set for image requests, allowing secure access to image files. This enhancement helps protect sensitive data during transfers and supports compliance with specific security and data protection standards without requiring complex configurations.

GanttChart

Bug fix

  • Previously, the ZoomToFit feature ignored the project’s startDate and endDate and always used task dates to set the timeline range. This issue has been fixed. Now, if project dates are provided, they will be used correctly; otherwise, task dates will be used.

Features

  • #F6474 - Added support for automatically generating and displaying hierarchical WBS codes (e.g., 1, 1.1, 1.1.1) based on task levels. This helps visualize task hierarchy and improves project organization and planning. Please find the demo link here

  • #I466566,#I547420,626150,625630 - Added support for defining task constraints using the taskFields.constraintType and taskFields.constraintDate properties. These options allow you to control when a task can start or finish based on specific scheduling rules. Constraints can also be modified interactively through the task edit dialog and cell editing. Please find the demo link here

  • The table below provides information on newly added events and methods to the Gantt Chart.

Events Arguments Description
cellSave rowData, columnName, cell, columnObject, value, isForeignKey, column, previousValue Triggers before a cell’s value is committed in the Gantt Chart. The event argument provides details about the cell being edited, including the option to cancel the save operation using a cancel flag.
beforeDataBound Object Triggers before the data is bound to the Gantt TreeGrid. Used for pre-processing or modifying data, such as filtering or transforming, before it renders in the DOM.
autoFitColumns fieldNames Auto-fits column widths based on content size. When no parameters are passed, all visible columns are adjusted. Hidden columns are excluded. If specific column field names are provided, only those columns are adjusted.
getCurrentViewData   Returns the current view data collection in the Gantt Chart. Reflects the latest data after actions such as filtering, sorting, and CRUD operations.
getTaskInfo taskId Fetches the internal properties of a Gantt task, including taskbar left and width, start and end dates, predecessor details, resource assignments, and other task-specific configurations.
     

Grid

Bug Fixes

  • #I715508 - Introduced the columnMenuClose and contextMenuClose events, which are triggered upon closing their respective menus. These events offer enhanced control over menu dismissal actions.
  • #I709217 - Introduced the reorderColumnByModel method to support programmatic reordering of individual columns as well as stacked header columns.

Features

  • Added support to visualize selected Grid records as charts using context menu options. This functionality is powered by the new @syncfusion/ej2-grid-chart package, which displays a popup chart based on the selected data. Users can choose from various chart options and customize settings dynamically to suit their data visualization needs. Explore the demo here.

Breaking Changes

  • The beforeCustomFilterOpen event, which was previously an internal-only API, is now publicly accessible. This allows users to customize the filter UI before it is rendered.

Image Editor

Features

  • Added support to open images with specific width and height using the imageSettings parameter in the Open method. This enhancement introduces additional properties: width, height, and isAspectRatio, allowing precise control over image dimensions while optionally maintaining the original aspect ratio.

  • Provided Underline and Strikethrough formatting options for text annotations, enhancing the text styling capabilities in the Image Editor.

  • Added support to load BMP (Bitmap) image files via both the file uploader UI and programmatically through the Open method.

Bug Fixes

  • #I733422 - The issue with “Annotations were not returned in image data when calling the ‘getImageData’ method inside the ‘editComplete’ event” has been resolved.

PDF

Features

PDF Viewer

Bug Fixes

  • #I731429 - Resolved an issue where the rectangle annotation was not added correctly in the PDF Viewer when it was drawn quickly.

Features

  • #I712601 - Added support to dynamically enable or disable text selection in the PDF Viewer.
  • PDF Viewer now supports squiggly annotations. This feature allows users to highlight important sections of the text with wavy underlines, enhancing document review and collaboration. Squiggly annotations can be added, edited, and customized directly within the viewer, providing a seamless and intuitive experience for annotating PDFs.
  • #I687373 - Provided zooming support in the Page Organizer view of the PDF Viewer. This enhancement provides an interactive zoom experience to help users identify the pages they are organizing.

Pivot Table

Bug Fixes

  • #I733782 - The drill-through popup will now display the correct value header and value when the value field caption contains parentheses in the pivot table.

Features

  • Support has been added for performing value sorting simultaneously on both the row and column axes, independent of the value axis. This enhancement allows for more flexible and accurate data analysis across dimensions. Explore the demo here.
  • Support has been introduced for exporting the pivot table as a native Excel PivotTable, preserving the pivot structure in the exported file. Users can continue interacting with and customizing the pivot data directly within Excel. Explore the demo here.
  • Support has been added for including headers and footers during Excel exporting with the server-side engine in the pivot table. Explore the demo here.

Presentation

Features

  • Font substitution is now supported inside charts, allowing users to configure fallback fonts when the original fonts are unavailable during PowerPoint to PDF and image conversions.
  • Provided fallback font support for Unicode characters in charts to preserve multilingual content during PowerPoint-to-PDF and image conversions.
  • Improved preservation of EMF and WMF metafile images as searchable content during PowerPoint-to-PDF conversions.

Breaking Changes

  • Changed the assemblies name of “Syncfusion.MetafileRenderer.NET.dll” into “Syncfusion.MetafileRenderer.Portable.dll” in the build and NuGet package.
  • Added the assembly of “Syncfusion.PDF.Portable.dll” as a dependency of “Syncfusion.MetafileRenderer.Portable.dll” in the build and NuGet package.

QueryBuilder

Breaking Changes

  • The following QueryBuilderRule property type was changed.
Property Previous Type Current Type
IsLocked boolean boolean?

Rich Text Editor

Features

  • Insert Code Block: The Code Block feature allows users to insert formatted code snippets into the Rich Text Editor using a toolbar button or the Ctrl+Shift+B shortcut. A dropdown menu enables language selection for each code block, supporting options like JavaScript, Python, and HTML. This feature is fully customizable via the Languages property an array of objects defining the available programming languages and the DefaultLanguage property, which sets the default language for newly inserted code blocks. Please find the demo here.

  • Insert Horizontal Line - The Horizontal Line toolbar item enables users to insert a horizontal rule (<hr>) element into the Rich Text Editor with a single click on the dedicated toolbar button. This feature renders a divider line that spans the full width of the editor, helping to visually separate content sections and improve readability. To enable this option, add HorizontalLine to the toolbar items configuration. Please find the demo here.

  • Bottom Toolbar - The Bottom Toolbar feature introduces a fixed toolbar at the bottom of the Rich Text Editor, offering quick access to frequently used formatting tools. It enhances usability, especially in constrained layouts or on mobile devices, by providing a compact and accessible interface. The toolbar’s position is configurable via the API using the RichTextEditorToolbarSettings.Position property, which accepts ToolbarPosition.Top or ToolbarPosition.Bottom enums to control the toolbar placement. Please find the demo link here.

  • Popup Toolbar - The Popup toolbar for the toolbar automatically relocates overflowing toolbar items into a popup container when there isn’t enough space to display them, making it especially useful for constrained layouts or smaller screens. This behavior enhances usability while maintaining a clean and responsive editing experience. It can be configured via the API using the RichTextEditorToolbarSettings.Type property, which accepts the ToolbarType.Popup enum value to enable this mode. Please find the demo link here.

  • MaxFileSize - The MaxFileSize Support feature in the Rich Text Editor allows developers to configure a maximum file size limit for uploaded media files, including images, audio, and video, helping to validate uploads and prevent over sized content. This is achieved through the RichTextEditorImageSettings.MaxFileSize property and similar properties for audio and video uploads. By default, the limit is set to 30MB, but it can be customized per media type to suit specific application requirements.

  • Table row and column copy paste - The Table Row or Column Copy, Cut, and Paste Support feature in the Rich Text Editor enhances table functionality by allowing users to efficiently copy, cut, and paste specific rows or columns using standard keyboard shortcuts Ctrl+C, Ctrl+X, Ctrl+V. This streamlines the editing process and enables quick duplication or reorganization of table data without the need for manual re-entry. Please find the demo here.

  • Enhance the quick toolbar - The Enhanced Quick Toolbar offers improved integration with the editor’s workflow by streamlining content creation and ensuring an uninterrupted editing experience. It provides better positioning and responsiveness, allowing users to access contextual tools seamlessly without distracting from the content, thereby enhancing overall usability and productivity. Please find the demo here.

  • Show recent color - The Show Recent Color Support feature in the Rich Text Editor enhances the font color and background color pickers by displaying recently used colors, allowing users to quickly access and reuse them for consistent formatting. This improves efficiency and ensures visual uniformity across content. The feature is configurable via the ShowRecentColors property a boolean that defaults to true enabling developers to toggle the recent colors panel in the color pickers to suit application preferences while maintaining an intuitive and streamlined editing experience. Please find the demo here.

  • ClearUndoRedo - The Clear undo redo in the Rich Text Editor, allows users to clear the undo and redo history through a dedicated action. This functionality is accessible via the clearUndoRedo public method, which can be invoked programmatically to reset the history.

Bug Fixes

  • #I733621 - Now, The issue with applying bold to the main bullet, which also affected sub-bullets in the Rich Text Editor, has now been resolved.

  • #I733547 - Now, The issue with the setting Default in the FontSize toolbar does not reset the fontSize in the RichTextEditor has now been resolved.

  • #I732468 - Now, The issue with arrow key navigation behaves incorrectly in pasted tables with in the Rich Text Editor has now been resolved.

  • #I733361 - Now, The issue with the entire paragraph becomes a hyperlink when pasted after a link in the Rich Text Editor has now been resolved.

Breaking Changes

Quick Toolbar Positioning Improvements

  • Enhanced positioning logic: The Rich Text Editor’s positioning system has been completely redesigned to prevent content from being hidden when editing tables and images.

  • Default scroll behavior change: The ActionOnScroll property in QuickToolbarSettings has been changed from hide to none by default.

  • Deprecated event arguments: The PositionX and PositionY arguments in the BeforeQuickToolbarOpen event have been deprecated and will be removed in future versions.

  • Default items: The default order of the items in Table, Image, Audio and Video quick toolbar has been changed. The quick toolbar items will appear on a single line by default.

Previous value

{
    ActionOnScroll: 'hide',
    Table: ['TableHeader', 'TableRows', 'TableColumns', 'BackgroundColor', '-', 'TableRemove', 'Alignments', 'TableCellVerticalAlign', 'Styles'],
    Image: ['Replace', 'Align', 'Caption', 'Remove', '-', 'InsertLink', 'Display', 'AltText', 'Dimension'],
    Audio: ['AudioReplace', 'AudioRemove', 'AudioLayoutOption'],
    Video: ['VideoReplace', 'VideoAlign', 'VideoRemove', 'VideoLayoutOption', 'VideoDimension']
}

New value

{
    ActionOnScroll: 'none',
    Table: ['TableHeader', 'TableRemove', '|', 'TableRows', 'TableColumns', '|', 'Styles', 'BackgroundColor', 'Alignments', 'TableCellVerticalAlign'],
    Image: ['AltText', 'Caption', '|', 'Align', 'Display', '|', 'InsertLink', 'OpenImageLink', 'EditImageLink', 'RemoveImageLink', '|', 'Dimension', 'Replace', 'Remove'],
    Audio: ['AudioLayoutOption', 'AudioReplace', 'AudioRemove'],
    Video: ['VideoLayoutOption', 'VideoAlign', '|', 'VideoDimension', 'VideoReplace', 'VideoRemove']
}

Spreadsheet

Features

  • Improved Excel import performance: Added support to skip styles and formats during Excel file import using the server-side library. This optimization reduces the generated JSON size and significantly improves rendering speed, especially for large or style-heavy Excel files.

Stock Chart

Features

  • Added support to highlight the last value of the series with a label and grid line indicator, offering a clear and immediate reference point for the series endpoint. Explore the demo here

Breaking Changes

  • The value type of the emptyPointMode property has been updated from AccEmptyPointMode to the EmptyPointMode enum to define the proper empty point mode.

Tab

Bug Fixes

  • #F733919 - The issue with the context menu popup does not open when we press Shift+F10 key has been resolved.

Toolbar

Features

  • A callback event called keyDown has been provided to customize the built-in keyboard interactions in the Toolbar.

Bug Fixes

  • #I731032 - An issue where focus moved to a disabled item in the toolbar popup when pressing the down arrow key has been fixed.

Tree Grid

Features

  • Introduced sticky header support in the Tree Grid, allowing column headers to stay fixed during scrolling. This improves navigation and readability in large hierarchical data views. Explore the demo here.

  • Enhanced support for LoadChildOnDemand in the Tree Grid with remote data binding and virtual scrolling. This improvement enables efficient, on-demand retrieval of child records, ensuring smoother performance when working with large hierarchical datasets.

TreeView

Bug Fixes

  • #I730143 - The flickering issue on animation due to height calculation while expanding a node in TreeView has been resolved.

XlsIO

Features

  • Auto Fill and Fill Series support is provided to programmatically populate Excel cell ranges based on patterns, sequences, or trends, minimizing manual input.
  • Font substitution is supported to allow configuration of fallback fonts when the original fonts are unavailable during chart-to-image conversion, ensuring visual consistency.
  • Fallback font handling for Unicode text is implemented during chart-to-image conversion, enabling proper rendering when the default fonts lack the necessary glyphs.
  • Preservation of EMF and WMF metafile images as searchable content during Excel to PDF conversion is supported.

Bug Fixes

  • #I735455 - Cell value is accurately returned by the Range.Value property when the number contains high-precision digits.
  • #I737657 - The IsFiltered property is updated properly when clearing a filter contains equal to operator.
  • #I736030 - Hyperlinks are removed properly when performing clear operations in worksheet range.

Breaking Changes

  • Changed the assembly name of “Syncfusion.MetafileRenderer.NET.dll” into “Syncfusion.MetafileRenderer.Portable.dll” in build and NuGet package.
  • Added the assembly of “Syncfusion.PDF.Portable.dll” as a dependency of “Syncfusion.MetafileRenderer.Portable.dll” in the build and NuGet package.

Test Results

Component Name Test Cases Passed Failed Remarks
3D Chart 232 232 0 All Passed
3D Circular Chart 374 374 0 All Passed
Accordion 106 106 0 All Passed
AI Assist View 431 431 0 All Passed
AutoComplete 200 200 0 All Passed
Breadcrumb 160 160 0 All Passed
Bullet Chart 165 165 0 All Passed
Button 145 145 0 All Passed
ButtonGroup 120 120 0 All Passed
calendar 177 177 0 All Passed
Chart 3898 3898 0 All Passed
Chat UI 184 184 0 All Passed
CircularGauge 429 429 0 All Passed
ColorPicker 130 130 0 All Passed
Common 685 685 0 All Passed
Context Menu 105 105 0 All Passed
Data Grid 2736 2736 0 All Passed
Date Picker 422 422 0 All Passed
Date Range Picker 419 419 0 All Passed
Date Time Picker 322 322 0 All Passed
Diagram 18619 18619 0 All Passed
Document Editor 3668 3668 0 All Passed
DropDown Button 132 132 0 All Passed
Dropdown List 191 191 0 All Passed
Dropdown Tree 105 105 0 All Passed
File Manager 2196 2196 0 All Passed
Floating Action Button 174 174 0 All Passed
Gantt 2992 2992 0 All Passed
HeatMap Chart 478 478 0 All Passed
Image Editor 1653 1653 0 All Passed
In-place Editor 642 642 0 All Passed
Kanban 268 268 0 All Passed
LinearGauge 426 426 0 All Passed
Listbox 115 115 0 All Passed
Maps 1290 1290 0 All Passed
Menu 187 187 0 All Passed
Multicolumn Combo Box 254 254 0 All Passed
Multiselect Dropdown 310 310 0 All Passed
OTP Input 240 240 0 All Passed
PDF Viewer 17966 17966 0 All Passed
Pivot Table 2714 2714 0 All Passed
Progress Button 132 132 0 All Passed
Query Builder 480 480 0 All Passed
RangeNavigator 138 138 0 All Passed
Rating 201 201 0 All Passed
Ribbon 487 487 0 All Passed
Rich Text Editor 4594 4594 0 All Passed
schedule 4578 4578 0 All Passed
Signature 105 105 0 All Passed
Skeleton 144 144 0 All Passed
Slider 147 147 0 All Passed
Speech To Text 200 200 0 All Passed
Speed Dial 366 366 0 All Passed
Split Button 144 144 0 All Passed
Spreadsheet 10031 10031 0 All Passed
Stepper 138 138 0 All Passed
Stock Chart 379 379 0 All Passed
Text Area 107 107 0 All Passed
Time Picker 265 265 0 All Passed
Timeline 213 213 0 All Passed
Toast 154 154 0 All Passed
Toolbar 125 125 0 All Passed
ToolTip 147 147 0 All Passed
TreeGrid 3116 3116 0 All Passed
Treemap 264 264 0 All Passed
Treeview 344 344 0 All Passed
DocIO 16250 16250 0 All Passed
Metafilerenderer 1701 1701 0 All Passed
PDF 12431 12431 0 All Passed
Presentation 55865 55865 0 All Passed
XlsIO 17302 17302 0 All Passed