Skip to content

Commit e218386

Browse files
Mohan2401Mohan2401
authored
Merge branch 'hotfix/hotfix-v31.2.12' into 988545-DisplayCurrencySymbol
2 parents 6b18395 + f9ce28a commit e218386

18 files changed

+653
-196
lines changed

‎Document-Processing-toc.html‎

Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2413,6 +2413,9 @@
24132413
<li>
24142414
<a href="/document-processing/pdf/pdf-library/net/working-with-JavaScript">Working with JavaScript</a>
24152415
</li>
2416+
<li>
2417+
<a href="/document-processing/pdf/pdf-library/net/Performance-Metrics">Performance Metrics</a>
2418+
</li>
24162419
<li>
24172420
FAQ
24182421
<ul>
@@ -2607,6 +2610,9 @@
26072610
<li>
26082611
<a href="/document-processing/pdf/conversions/html-to-pdf/net/features">Features</a>
26092612
</li>
2613+
<li>
2614+
<a href="/document-processing/pdf/conversions/html-to-pdf/net/Performance-Metrics">Performance Metrics</a>
2615+
</li>
26102616
<li>
26112617
<a href="/document-processing/pdf/conversions/html-to-pdf/net/advanced-installation">Advanced Installation</a>
26122618
</li>
@@ -5848,6 +5854,30 @@
58485854
<li>
58495855
<a href="/document-processing/excel/excel-library/net/faqs/does-xlsio-support-auto-correcting formulas">Does XlsIO support auto-correcting formulas?</a>
58505856
</li>
5857+
<li>
5858+
<a href="/document-processing/excel/excel-library/net/faqs/how-are-spaces-in-cell-values-handled-by-xlsio-during-calculation">How are spaces in cell values handled by XlsIO during calculation?</a>
5859+
</li>
5860+
<li>
5861+
<a href="/document-processing/excel/excel-library/net/faqs/what-is-the-maximum-text-length-for-hyperlink-screentip-in-excel">What is the maximum text length for hyperlink ScreenTip in Excel?</a>
5862+
</li>
5863+
<li>
5864+
<a href="/document-processing/excel/excel-library/net/faqs/does-xlsio-autofit-row-and-column-sizes-based-on-images">Does XlsIO autofit row and column sizes based on images?</a>
5865+
</li>
5866+
<li>
5867+
<a href="/document-processing/excel/excel-library/net/faqs/does-xlsio-auto-adjust-chart-axis-minimum-and-maximum-values">Does XlsIO auto-adjust chart axis minimum and maximum values?</a>
5868+
</li>
5869+
<li>
5870+
<a href="/document-processing/excel/excel-library/net/faqs/does-xlsio-prefix-pivot-table-calculated-field-headers-with-sum-of">Does XlsIO prefix PivotTable calculated field headers with "Sum of"?</a>
5871+
</li>
5872+
<li>
5873+
<a href="/document-processing/excel/excel-library/net/faqs/can-pivot-tables-share-calculate-field-names">Can PivotTables share calculated field names?</a>
5874+
</li>
5875+
<li>
5876+
<a href="/document-processing/excel/excel-library/net/faqs/what-are-the-naming-rules-for-named-ranges-in-Excel">What are the naming rules for named ranges in Excel?</a>
5877+
</li>
5878+
<li>
5879+
<a href="/document-processing/excel/excel-library/net/faqs/what-is-the-unit-of-row-height-and-column-width-in-Excel">What is the unit of row height and column width in Excel?</a>
5880+
</li>
58515881
</ul>
58525882
</li>
58535883
</ul>
@@ -6994,11 +7024,15 @@
69947024
<li>
69957025
Weekly Nuget Release
69967026
<ul>
7027+
<li><a href="/document-processing/release-notes/v31.2.15">v31.2.15</a></li>
7028+
<li><a href="/document-processing/release-notes/v31.2.10">v31.2.10</a></li>
7029+
<li><a href="/document-processing/release-notes/v31.2.5">v31.2.5</a></li>
7030+
<li><a href="/document-processing/release-notes/v31.2.4">v31.2.4</a></li>
7031+
<li><a href="/document-processing/release-notes/v31.2.3">v31.2.3</a></li>
69977032
<li><a href="/document-processing/release-notes/v31.1.23">v31.1.23</a></li>
69987033
<li><a href="/document-processing/release-notes/v31.1.22">v31.1.22</a></li>
69997034
<li><a href="/document-processing/release-notes/v31.1.21">v31.1.21</a></li>
70007035
<li><a href="/document-processing/release-notes/v31.1.20">v31.1.20</a></li>
7001-
<li><a href="/document-processing/release-notes/v31.1.19">v31.1.19</a></li>
70027036
<li><a href="/document-processing/release-notes/v31.1.18">v31.1.18</a></li>
70037037
</ul>
70047038
</li>

‎Document-Processing/Excel/Excel-Library/NET/faqs/does-xlsio-auto-adjust-chart-axis-minimum-and-maximum-values.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
title: Chart axis auto-adjust in XlsIO | Syncfusion
3+
description: This page explains whether Syncfusion XlsIO supports auto adjustment of chart axis values using Syncfusion .NET Excel library (XlsIO).
4+
platform: document-processing
5+
control: XlsIO
6+
documentation: UG
7+
---
8+
9+
# Does XlsIO auto-adjust chart axis minimum and maximum values?
10+
11+
No. In Microsoft Excel, if the axis maximum value is lower than the minimum value, Excel automatically adjusts the minimum value (for example, a minimum of 1.25 and maximum of 0 may yield a minimum like -10). XlsIO does not support this auto adjustment of chart axis values. When configuring chart axes, ensure that the maximum value is greater than the minimum value.
12+
13+
For details on setting chart axis minimum and maximum values in XlsIO, see the <a href="https://help.syncfusion.com/document-processing/excel/excel-library/net/charts/chart-axis#axis-settings">Chart Axis Settings</a>.

‎Document-Processing/Excel/Excel-Library/NET/faqs/does-xlsio-prefix-pivot-table-calculated-field-headers-with-sum-of.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: PivotTable calculated field header prefix in XlsIO | Syncfusion
3+
description: This page explains whether Syncfusion XlsIO prefixes PivotTable calculated field headers with "Sum of" when adding a calculated field.
4+
platform: document-processing
5+
control: XlsIO
6+
documentation: UG
7+
---
8+
9+
# Does XlsIO prefix PivotTable calculated field headers with "Sum of"?
10+
11+
Yes. When a calculated field is added to a PivotTable, Microsoft Excel automatically prefixes the column header with **Sum of** before the original name. For example, a field named **Profit** becomes **Sum of Profit**. XlsIO follows the same behavior to remain consistent with Excel.

‎Document-Processing/Excel/Excel-Library/NET/faqs/what-is-the-unit-of-row-height-and-column-width-in-Excel.md‎

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
---
2+
title: Unit of row height and column width in Excel | Syncfusion
3+
description: This page explains about the default unit of measurement for row height and column width in Excel using Syncfusion .NET Excel library (XlsIO).
4+
platform: document-processing
5+
control: XlsIO
6+
documentation: UG
7+
---
8+
9+
# What is the unit of row height and column width in Excel?
10+
11+
By default, XlsIO uses **points** as the unit of measurement for both row height and column width.
12+
13+
Use <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_SetColumnWidth_System_Int32_System_Double_">SetColumnWidth</a>
14+
and <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_SetRowHeight_System_Int32_System_Double_">SetRowHeight</a> to set dimensions in points.
15+
16+
Use <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_GetColumnWidth_System_Int32_">GetColumnWidth</a> and <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_GetRowHeight_System_Int32_">GetRowHeight</a> to retrieve dimensions in points.
17+
18+
If you need pixel values, XlsIO provides pixel based APIs: <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_GetColumnWidthInPixels_System_Int32_">GetColumnWidthInPixels</a>, <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_GetRowHeightInPixels_System_Int32_">GetRowHeightInPixels</a>, <a href="https://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_SetColumnWidthInPixels_System_Int32_System_Int32_">SetColumnWidthInPixels</a>, <a href="http://help.syncfusion.com/cr/document-processing/Syncfusion.XlsIO.IWorksheet.html#Syncfusion_XlsIO_IWorksheet_SetRowHeightInPixels_System_Int32_System_Double_">SetRowHeightInPixels</a>.
19+
20+
{% tabs %}
21+
{% highlight c# tabtitle="C# [Cross-platform]" %}
22+
//Set column width in points
23+
sheet.SetColumnWidth(1, 20);
24+
25+
//Get column width in points
26+
var widthPoints = sheet.GetColumnWidth(1);
27+
Console.WriteLine("Column width in points: " + widthPoints);
28+
29+
//Set column width in pixels
30+
sheet.SetColumnWidthInPixels(1, 160);
31+
32+
//Get column width in pixels
33+
var widthPixels = sheet.GetColumnWidthInPixels(1);
34+
Console.WriteLine("Column width in pixels: " + widthPixels);
35+
36+
//Set row height in points
37+
sheet.SetRowHeight(1, 15);
38+
39+
//Get row height in points
40+
var heightPoints = sheet.GetRowHeight(1);
41+
Console.WriteLine("Row height in points: " + heightPoints);
42+
43+
//Set row height in pixels
44+
sheet.SetRowHeightInPixels(1, 40);
45+
46+
//Get row height in pixels
47+
var heightPixels = sheet.GetRowHeightInPixels(1);
48+
Console.WriteLine("Row height in pixels: " + heightPixels);
49+
{% endhighlight %}
50+
51+
{% highlight c# tabtitle="C# [Windows-specific]" %}
52+
//Set column width in points
53+
sheet.SetColumnWidth(1, 20);
54+
55+
//Get column width in points
56+
var widthPoints = sheet.GetColumnWidth(1);
57+
Console.WriteLine("Column width in points: " + widthPoints);
58+
59+
//Set column width in pixels
60+
sheet.SetColumnWidthInPixels(1, 160);
61+
62+
//Get column width in pixels
63+
var widthPixels = sheet.GetColumnWidthInPixels(1);
64+
Console.WriteLine("Column width in pixels: " + widthPixels);
65+
66+
//Set row height in points
67+
sheet.SetRowHeight(1, 15);
68+
69+
//Get row height in points
70+
var heightPoints = sheet.GetRowHeight(1);
71+
Console.WriteLine("Row height in points: " + heightPoints);
72+
73+
//Set row height in pixels
74+
sheet.SetRowHeightInPixels(1, 40);
75+
76+
//Get row height in pixels
77+
var heightPixels = sheet.GetRowHeightInPixels(1);
78+
Console.WriteLine("Row height in pixels: " + heightPixels);
79+
{% endhighlight %}
80+
81+
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
82+
'Set column width in points
83+
sheet.SetColumnWidth(1, 20)
84+
85+
'Get column width in points
86+
Dim widthPoints As Integer = sheet.GetColumnWidth(1)
87+
Console.WriteLine("Column width in points: " & widthPoints)
88+
89+
'Set column width in pixels
90+
sheet.SetColumnWidthInPixels(1, 160)
91+
92+
'Get column width in pixels
93+
Dim widthPixels As Integer = sheet.GetColumnWidthInPixels(1)
94+
Console.WriteLine("Column width in pixels: " & widthPixels)
95+
96+
'Set row height in points
97+
sheet.SetRowHeight(1, 15)
98+
99+
'Get row height in points
100+
Dim heightPoints As Integer = sheet.GetRowHeight(1)
101+
Console.WriteLine("Row height in points: " & heightPoints)
102+
103+
'Set row height in pixels
104+
sheet.SetRowHeightInPixels(1, 40)
105+
106+
'Get row height in pixels
107+
Dim heightPixels As Integer = sheet.GetRowHeightInPixels(1)
108+
Console.WriteLine("Row height in pixels: " & heightPixels)
109+
{% endhighlight %}
110+
{% endtabs %}

‎Document-Processing/PDF/Conversions/HTML-To-PDF/NET/Performance-Metrics.md‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
title: Performance Metrics of Syncfusion HTML-to-PDF Conversion
3+
description: This section provides a detailed overview of the performance metrics and capabilities of the HTML-to-PDF conversion library.
4+
platform: document-processing
5+
control: PDF
6+
documentation: UG
7+
---
8+
9+
# HTML to PDF Performance Benchmarks
10+
11+
The Syncfusion<sup>&reg;</sup> [HTML to PDF library](https://www.syncfusion.com/document-sdk/net-pdf-library/html-to-pdf) delivers high-performance APIs to convert web content into PDF documents programmatically. This performance benchmark report highlights the speed and efficiency of HTML-to-PDF conversion, showcasing how the library manages large-scale document rendering in real-world scenarios.
12+
13+
## Environment Details
14+
15+
The following system configurations were used for benchmarking:
16+
17+
OS Edition : Windows 11 Enterprise
18+
Version : 22H2
19+
Processor : 11th Gen Intel(R) Core(TM) i5-1135G7 @ 2.40GHz 2.42 GHz
20+
Installed RAM : 20.0 GB (19.7 GB usable)
21+
System type : 64-bit operating system, x64-based processor
22+
23+
## Example Application
24+
25+
The benchmark details were obtained using the [Syncfusion.HtmlToPdfConverter.Net.Windows](https://www.nuget.org/packages/Syncfusion.HtmlToPdfConverter.Net.Windows) package. You can refer to the following sample, as well as the input and output files used:
26+
27+
Input HTML files : [Input HTML files](https://github.com/SyncfusionExamples/html-to-pdf-csharp-examples/tree/master/Performance_Testing/Syncfusion_HTMLtoPDF/wwwroot/Data)
28+
29+
Output PDF files : [Output document](https://www.syncfusion.com/downloads/support/directtrac/general/ze/Output-924807763.zip)
30+
31+
## Results
32+
33+
<table border="1">
34+
<th style="font-size:14px" width="100px">Input Page count</th>
35+
<th style="font-size:14px">Conversion time
36+
37+
(Avg value of 5 conversions)
38+
</th>
39+
<th style="font-size:14px">Process Memory and CPU usage
40+
</th>
41+
<tr>
42+
<td>10+ Pages</td>
43+
<td>2.78 seconds</td>
44+
<td>
45+
Memory usage: 318 MB
46+
47+
CPU usage: 10%</td>
48+
</tr>
49+
<tr>
50+
<td>100+ pages</td>
51+
<td>3.65 seconds</td>
52+
<td>Memory usage: 367 MB
53+
54+
CPU usage: 14%</td>
55+
</tr>
56+
<tr>
57+
<td>1000+ pages</td>
58+
<td>6.72 seconds</td>
59+
<td>Memory usage: 813 MB
60+
61+
CPU usage: 27%</td>
62+
</tr>
63+
<tr>
64+
<td>10 documents with 100+ pages in a loop</td>
65+
<td>30.52 seconds</td>
66+
<td>
67+
Memory usage: 663 MB
68+
69+
CPU usage: 15%</td>
70+
</tr>
71+
<tr>
72+
<td>10 documents with 1000+ pages in a loop</td>
73+
<td>1 minute 10 seconds</td>
74+
<td>
75+
Memory usage: 2.2 GB
76+
77+
CPU usage: 64%</td>
78+
</tr>
79+
</table>
80+
81+
N> The performance metrics were recorded on a freshly configured machine. Speed and memory usage may vary if the machine is running other processes. Additionally, performance can be affected by:
82+
N> * External resources loaded in the HTML (such as images, scripts, and styles)
83+
N> * Network speed for online URL conversions
84+
N> * Hardware resources (CPU and memory)
85+
86+
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/html-to-pdf-csharp-examples/tree/master/Performance_Testing/Syncfusion_HTMLtoPDF).

‎Document-Processing/PDF/Conversions/HTML-To-PDF/NET/features.md‎

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -807,6 +807,96 @@ padding-left: 5px;
807807

808808
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/HTML%20to%20PDF/Blink/Create-custom-style-TOC-when-converting-HTML-to-PDF).
809809

810+
## Exclude cover page from TOC
811+
812+
This code snippet shows how to configure the Table of Contents (TOC) to skip the cover page by setting the starting page number. In this example, the cover page is a single page, so the TOC begins at page 1. For documents with multiple cover pages, adjust the starting page number as needed.
813+
814+
{% tabs %}
815+
816+
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/PDF-Examples/master/HTML%20to%20PDF/Blink/Skip-cover-page-in-TOC-page-numbering/.NET/Skip-cover-page-in-TOC-page-numbering/Program.cs, 300" %}
817+
818+
using Syncfusion.Drawing;
819+
using Syncfusion.HtmlConverter;
820+
using Syncfusion.Pdf;
821+
822+
// Create an instance of HTML-to-PDF converter
823+
HtmlToPdfConverter htmlConverter = new HtmlToPdfConverter();
824+
// Configure Blink converter settings
825+
BlinkConverterSettings blinkConverterSettings = new BlinkConverterSettings()
826+
{
827+
ViewPortSize = new Size(1280, 0), // Set viewport width for rendering
828+
EnableToc = true, // Enable Table of Contents (TOC)
829+
};
830+
// Set TOC starting page number to skip the cover page
831+
blinkConverterSettings.Toc.StartingPageNumber = 1;
832+
// Apply the settings to the converter
833+
htmlConverter.ConverterSettings = blinkConverterSettings;
834+
// Read the main HTML content and convert it to PDF
835+
string inputhtml = File.ReadAllText("input.html");
836+
PdfDocument document = htmlConverter.Convert(inputhtml, "");
837+
//Create cover page and insert to the 0th index.
838+
// Apply scaling settings for the cover page
839+
htmlConverter.ConverterSettings = new BlinkConverterSettings()
840+
{
841+
Scale = 1.5f
842+
};
843+
// Convert the cover page HTML to PDF
844+
string coverimage = File.ReadAllText("coverpage.html");
845+
PdfDocument coverPage = htmlConverter.Convert(coverimage, "");
846+
// Insert the cover page at the beginning of the main document
847+
document.Pages.Insert(0, coverPage.Pages[0]);
848+
// Save the PDF document
849+
document.Save("Output.pdf");
850+
//Dispose the document
851+
coverPage.Close(true);
852+
document.Close(true);
853+
htmlConverter.Close();
854+
855+
{% endhighlight %}
856+
857+
{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
858+
859+
Imports Syncfusion.Drawing
860+
Imports Syncfusion.HtmlConverter
861+
Imports Syncfusion.Pdf
862+
863+
' Create an instance of HTML-to-PDF converter
864+
Dim htmlConverter As New HtmlToPdfConverter()
865+
' Configure Blink converter settings
866+
Dim blinkConverterSettings As New BlinkConverterSettings() With {
867+
.ViewPortSize = New Size(1280, 0), ' Set viewport width for rendering
868+
.EnableToc = True ' Enable Table of Contents (TOC)
869+
}
870+
' Set TOC starting page number to skip the cover page
871+
blinkConverterSettings.Toc.StartingPageNumber = 1
872+
' Apply the settings to the converter
873+
htmlConverter.ConverterSettings = blinkConverterSettings
874+
' Read the main HTML content and convert it to PDF
875+
Dim inputhtml As String = File.ReadAllText("input.html")
876+
Dim document As PdfDocument = htmlConverter.Convert(inputhtml, "")
877+
' Create cover page and insert to the 0th index.
878+
' Apply scaling settings for the cover page
879+
htmlConverter.ConverterSettings = New BlinkConverterSettings() With {
880+
.Scale = 1.5F
881+
}
882+
' Convert the cover page HTML to PDF
883+
Dim coverimage As String = File.ReadAllText("coverpage.html")
884+
Dim coverPage As PdfDocument = htmlConverter.Convert(coverimage, "")
885+
' Insert the cover page at the beginning of the main document
886+
document.Pages.Insert(0, coverPage.Pages(0))
887+
' Save the PDF document
888+
document.Save("Output.pdf")
889+
' Dispose the documents
890+
coverPage.Close(True)
891+
document.Close(True)
892+
htmlConverter.Close()
893+
894+
{% endhighlight %}
895+
896+
{% endtabs %}
897+
898+
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/HTML%20to%20PDF/Blink/Skip-cover-page-in-TOC-page-numbering/.NET).
899+
810900
## Media Type
811901

812902
The Blink HTML Converter allows selection of media type while converting HTML to PDF. Blink rendering engine supports <b>Screen</b> and <b>Print</b> media types. Refer to the following code snippet to select Print [MediaType](https://help.syncfusion.com/cr/document-processing/Syncfusion.HtmlConverter.BlinkConverterSettings.html#Syncfusion_HtmlConverter_BlinkConverterSettings_MediaType).

0 commit comments

Comments
 (0)