documentation(EJ2-953283): Need to include "Performance Best Practices" UG document for Spreadsheet component in all EJ2 platforms

ej2-asp-core-mvc/spreadsheet/performance-best-practices.md

@@ -0,0 +1,269 @@
+---
+layout: post
+title: Performance Best Practices in ##Platform_Name## Syncfusion Spreadsheet Component
+description: Learn here all about performance best practices in Syncfusion ##Platform_Name## Spreadsheet component of Syncfusion Essential JS 2 and more.
+platform: ej2-asp-core-mvc
+control: Performance
+publishingplatform: ##Platform_Name##
+documentation: ug
+---
+
+# Performance Best Practices in ##Platform_Name## Spreadsheet control
+
+{% if page.publishingplatform == "aspnet-core" %}
+
+Performance optimization is crucial when working with large datasets in the [Syncfusion® ASP.NET Core Spreadsheet](https://www.syncfusion.com/aspnet-core-ui-controls/spreadsheet). This documentation outlines best practices to enhance data handling efficiency and ensure a smooth, responsive user experience during various spreadsheet operations.
+
+{% elsif page.publishingplatform == "aspnet-mvc" %}
+
+Performance optimization is crucial when working with large datasets in the [Syncfusion® ASP.NET MVC Spreadsheet](https://www.syncfusion.com/aspnet-mvc-ui-controls/spreadsheet). This documentation outlines best practices to enhance data handling efficiency and ensure a smooth, responsive user experience during various spreadsheet operations.
+
+{% endif %}
+
+## How to improve performance when opening Excel files in the Spreadsheet?
+
+### Virtual scrolling
+
+Virtual scrolling is an essential performance feature in the Spreadsheet that enhances rendering efficiency when handling large datasets. Instead of loading all rows and columns into the DOM at once, it renders only the cells visible within the viewport. As the user scrolls, additional rows or columns are dynamically loaded and rendered.
+
+This approach significantly reduces initial load time, DOM size, and memory usage — resulting in smoother rendering and interaction, especially when working with thousands of rows or columns.
+
+{% if page.publishingplatform == "aspnet-core" %}
+
+For more details, refer to the [virtual scrolling documentation](https://ej2.syncfusion.com/aspnetcore/documentation/spreadsheet/scrolling#virtual-scrolling).
+
+{% elsif page.publishingplatform == "aspnet-mvc" %}
+
+For more details, refer to the [virtual scrolling documentation](https://ej2.syncfusion.com/aspnetmvc/documentation/spreadsheet/scrolling#virtual-scrolling).
+
+{% endif %}
+
+### Chunk response processing
+
+When opening large Excel files with extensive data and features, server responses can become too large—leading to memory issues or connection failures during transmission. The Chunk Response Processing feature addresses this by breaking the response into smaller chunks and sending them in parallel to the client.
+
+These chunks are combined on the client side to load the Excel data smoothly into the Spreadsheet. This approach avoids transmission failures due to memory constraints and ensures reliable and efficient loading of large files.
+
+{% if page.publishingplatform == "aspnet-core" %}
+
+To enable the chunk response processing feature, you can refer to the following UG section:
+* [Chunk Response Processing](https://ej2.syncfusion.com/aspnetcore/documentation/spreadsheet/open-save#chunk-response-processing)
+
+{% elsif page.publishingplatform == "aspnet-mvc" %}
+
+To enable the chunk response processing feature, you can refer to the following UG section:
+* [Chunk Response Processing](https://ej2.syncfusion.com/aspnetmvc/documentation/spreadsheet/open-save#chunk-response-processing)
+
+{% endif %}
+
+### Configure JSON serialization options during open
+
+Serialization options in the Spreadsheet allows you to exclude specific features—such as styles, formats, charts, images, wrap, etc.—from the `Workbook JSON object` when opening it in the Spreadsheet using the `openFromJson` method. By skipping unnecessary features, you can significantly improve performance, especially when working with large or complex workbooks.
+
+This is particularly useful when:
+* You need only the raw data without formatting.
+* You're opening the `Workbook JSON object` in the Spreadsheet using the `openFromJson` method.
+* You want to minimize the size of the JSON payload and optimize processing speed.
+
+Refer to the following UG section to learn how to configure these options:
+
+{% if page.publishingplatform == "aspnet-core" %}
+
+* [Configure JSON serialization options during open](https://ej2.syncfusion.com/aspnetcore/documentation/spreadsheet/open-save#configure-json-deserialization-options)
+
+{% elsif page.publishingplatform == "aspnet-mvc" %}
+
+* [Configure JSON serialization options during open](https://ej2.syncfusion.com/aspnetmvc/documentation/spreadsheet/open-save#configure-json-deserialization-options)
+
+{% endif %}
+
+### Configuring threshold limits
+
+To improve performance when importing large Excel files into the Spreadsheet component, you can configure thresholds for both the maximum number of cells `MaximumDataLimit` and the file size `MaximumFileSize`. These limits help prevent delays or potential server timeouts by restricting excessively large files from being imported.
+
+When these thresholds are exceeded:
+* The Spreadsheet displays an alert dialog indicating that the file is large.
+  ![Limit file size and data](./images/fileSize_and_dataLimit.jpg)
+* Clicking **Cancel** aborts the open process.
+* Clicking **OK** proceeds with the open process.
+
+You can configure the `MaximumDataLimit` and `MaximumFileSize` thresholds on the server side using the following code example:
+
+**Code Snippet:**
+
+```csharp
+public IActionResult Open(IFormCollection openRequest)
+{
+    OpenRequest open = new OpenRequest();
+    open.File = openRequest.Files[0];
+    open.Guid = openRequest["Guid"];
+
+    // Set maximum allowed number of cells
+    open.ThresholdLimit.MaximumDataLimit = 1000000; // 1,000,000 cells
+
+    // Set maximum allowed file size in bytes (e.g., 5MB)
+    open.ThresholdLimit.MaximumFileSize = 5000000;
+
+    var openbook = Content(Workbook.Open(open));
+    return openbook;
+}
+```
+
+## How to improve performance on formula calculation in Spreadsheet?
+
+### Manual calculation mode
+
+Manual Calculation Mode in the Spreadsheet is a performance optimization feature that allows you to delay formula recalculations until they are explicitly triggered. By default, the Spreadsheet automatically recalculates formulas whenever a dependent cell is edited or changed. While this behavior works well for small datasets, it can result in noticeable lag or UI freezing when working with large spreadsheets that contain many formulas or complex calculation chains.
+
+To prevent such performance issues during bulk operations—such as importing data, applying formats, or setting multiple formulas — manual calculation mode gives developers control over when recalculations should occur.
+
+Enabling manual mode is highly beneficial when:
+* Importing large Excel or JSON files with formula-heavy sheets.
+* Performing bulk updates (e.g., updating rows or columns via code).
+* Applying formulas dynamically to a large number of cells.
+* You want to postpone calculations until all content or changes are finalized.
+
+{% if page.publishingplatform == "aspnet-core" %}
+
+To learn more about Manual Calculation Mode and how to enable it, you can refer to the following [UG link](https://ej2.syncfusion.com/aspnetcore/documentation/spreadsheet/formulas#manual-mode).
+
+{% elsif page.publishingplatform == "aspnet-mvc" %}
+
+To learn more about Manual Calculation Mode and how to enable it, you can refer to the following [UG link](https://ej2.syncfusion.com/aspnetmvc/documentation/spreadsheet/formulas#manual-mode).
+
+{% endif %}
+
+## How to improve save performance in the Spreadsheet?
+
+### Handling large file saves with `isFullPost` option
+
+{% if page.publishingplatform == "aspnet-core" %}
+
+When saving large Excel files with extensive data and features using **File → Save As** or the **save** method, the Spreadsheet triggers a server API call through a form submit operation. This can lead to performance issues such as timeouts or delays, particularly due to the size and complexity of the workbook.
+
+To mitigate these issues during the save operation, you can set the `isFullPost` property to **false** in the [`beforeSave`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Spreadsheet.Spreadsheet.html#Syncfusion_EJ2_Spreadsheet_Spreadsheet_BeforeSave) event of the Spreadsheet.
+
+The following code example shows how to set `isFullPost` to **false** in the Spreadsheet component:
+
+{% tabs %}
+{% highlight cshtml tabtitle="CSHTML" %}
+
+<ejs-spreadsheet id="spreadsheet" beforeSave="beforeSave" openUrl="Home/Open" saveUrl="Home/Save">
+</ejs-spreadsheet>
+
+<script>
+       function beforeSave(args) {
+            args.isFullPost = false; 
+    	}
+</script>
+
+{% endhighlight %}
+{% endtabs %}
+
+{% elsif page.publishingplatform == "aspnet-mvc" %}
+
+When saving large Excel files with extensive data and features using **File → Save As** or the **save** method, the Spreadsheet triggers a server API call through a form submit operation. This can lead to performance issues such as timeouts or delays, particularly due to the size and complexity of the workbook.
+
+To mitigate these issues during the save operation, you can set the `isFullPost` property to **false** in the [`beforeSave`](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Spreadsheet.Spreadsheet.html#Syncfusion_EJ2_Spreadsheet_Spreadsheet_BeforeSave) event of the Spreadsheet.
+
+The following code example shows how to set `isFullPost` to **false** in the Spreadsheet component:
+
+{% tabs %}
+{% highlight razor tabtitle="CSHTML" %}
+@Html.EJS().Spreadsheet("spreadsheet").OpenUrl("/Home/Open").SaveUrl("/Home/Save").BeforeSave("beforeSave").Render()
+
+<script>
+    function beforeSave(args) {
+        args.isFullPost = false; 
+    }
+</script>
+{% endhighlight %}
+{% endtabs %}
+
+{% endif %}
+
+### Configure JSON serialization options during save
+
+Serialization options in the Spreadsheet allows you to exclude specific features such as styles, formats, charts, images, wrap, etc. from the `Workbook JSON object` when saving it using the `saveAsJson` method in the Spreadsheet. By skipping unnecessary features, you can significantly improve performance, especially when working with large or complex workbooks.
+
+This is particularly useful when:
+* You need only the raw data without formatting.
+* You're saving the `Workbook JSON object` using the `saveAsJson` method in the Spreadsheet.
+* You want to minimize the size of the JSON payload and optimize processing speed.
+
+Proper use of serialization options during save improves performance and reduces the time taken during the save process.
+
+Refer to the following UG section to learn how to configure these options:
+
+{% if page.publishingplatform == "aspnet-core" %}
+
+* [Configure JSON serialization options during save](https://ej2.syncfusion.com/aspnetcore/documentation/spreadsheet/open-save#configure-json-serialization-options)
+
+{% elsif page.publishingplatform == "aspnet-mvc" %}
+
+* [Configure JSON serialization options during save](https://ej2.syncfusion.com/aspnetmvc/documentation/spreadsheet/open-save#configure-json-serialization-options)
+
+{% endif %}
+
+## How to improve cell selection performance in Spreadsheet?
+
+### Disabling aggregate calculation
+
+When working with large datasets in the Spreadsheet, user interactions such as selecting a large range of cells can experience delays. This occurs because, by default, the Spreadsheet performs aggregate calculations (e.g., SUM, AVERAGE, COUNT, MIN, and MAX) on the selected range and displays the results in the sheet tab panel at the bottom-right corner.
+
+{% if page.publishingplatform == "aspnet-core" %}
+
+To enhance the responsiveness of cell selection, particularly in performance-critical scenarios, consider disabling unnecessary aggregate calculations using the [`showAggregate`](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.Spreadsheet.Spreadsheet.html#Syncfusion_EJ2_Spreadsheet_Spreadsheet_ShowAggregate) property.
+
+Benefits:
+* Reduces selection lag when dealing with large data ranges.
+* Prevents real-time computation of formulas like SUM, AVERAGE, MIN, and MAX for large selections.
+* Keeps the UI responsive during large selection operations.
+
+You can disable aggregate calculation using the following code example:
+
+{% tabs %}
+{% highlight cshtml tabtitle="CSHTML" %}
+
+<ejs-spreadsheet id="spreadsheet" showAggregate="false" openUrl="Home/Open" saveUrl="Home/Save">
+</ejs-spreadsheet>
+
+{% endhighlight %}
+{% endtabs %}
+
+{% elsif page.publishingplatform == "aspnet-mvc" %}
+
+To enhance the responsiveness of cell selection, particularly in performance-critical scenarios, consider disabling unnecessary aggregate calculations using the [`showAggregate`](https://help.syncfusion.com/cr/aspnetmvc-js2/Syncfusion.EJ2.Spreadsheet.Spreadsheet.html#Syncfusion_EJ2_Spreadsheet_Spreadsheet_ShowAggregate) property.
+
+Benefits:
+* Reduces selection lag when dealing with large data ranges.
+* Prevents real-time computation of formulas like SUM, AVERAGE, MIN, and MAX for large selections.
+* Keeps the UI responsive during large selection operations.
+
+You can disable aggregate calculation using the following code example:
+
+{% tabs %}
+{% highlight razor tabtitle="CSHTML" %}
+
+@Html.EJS().Spreadsheet("spreadsheet").OpenUrl("/Home/Open").SaveUrl("/Home/Save").ShowAggregate(false).Render()
+
+{% endhighlight %}
+{% endtabs %}
+
+{% endif %}
+
+## See Also
+
+{% if page.publishingplatform == "aspnet-core" %}
+
+* [Open and Save](https://ej2.syncfusion.com/aspnetcore/documentation/spreadsheet/open-save)
+* [Docker Deployment](https://ej2.syncfusion.com/aspnetcore/documentation/spreadsheet/docker-deployment)
+* [Scrolling](https://ej2.syncfusion.com/aspnetcore/documentation/spreadsheet/scrolling)
+
+{% elsif page.publishingplatform == "aspnet-mvc" %}
+
+* [Open and Save](https://ej2.syncfusion.com/aspnetmvc/documentation/spreadsheet/open-save)
+* [Docker Deployment](https://ej2.syncfusion.com/aspnetmvc/documentation/spreadsheet/docker-deployment)
+* [Scrolling](https://ej2.syncfusion.com/aspnetmvc/documentation/spreadsheet/scrolling)
+
+{% endif %}

ej2-asp-core-toc.html

@@ -2665,6 +2665,7 @@
 		<li><a href="/ej2-asp-core/spreadsheet/undo-redo">Undo and Redo</a></li>
 		<li><a href="/ej2-asp-core/spreadsheet/ribbon">Ribbon</a></li>
 		<li><a href="/ej2-asp-core/spreadsheet/print">Print</a></li>
+		<li><a href="/ej2-asp-core/spreadsheet/performance-best-practices">Performance Best Practices</a></li>
 		<li><a href="/ej2-asp-core/spreadsheet/global-local">Globalization</a></li>
 		<li><a href="/ej2-asp-core/spreadsheet/accessibility">Accessibility</a></li>
 		<li><a href="/ej2-asp-core/spreadsheet/keyboard-shortcuts">Keyboard Shortcuts</a></li>

ej2-asp-mvc-toc.html

@@ -2628,6 +2628,7 @@
 		<li><a href="/ej2-asp-mvc/spreadsheet/undo-redo">Undo and Redo</a></li>
 		<li><a href="/ej2-asp-mvc/spreadsheet/ribbon">Ribbon</a></li>
 		<li><a href="/ej2-asp-mvc/spreadsheet/print">Print</a></li>
+		<li><a href="/ej2-asp-mvc/spreadsheet/performance-best-practices">Performance Best Practices</a></li>
 		<li><a href="/ej2-asp-mvc/spreadsheet/global-local">Globalization</a></li>
 		<li><a href="/ej2-asp-mvc/spreadsheet/accessibility">Accessibility</a></li>
 		<li><a href="/ej2-asp-mvc/spreadsheet/keyboard-shortcuts">Keyboard Shortcuts</a></li>