DOCINFRA-2341_merged_using_automation

Document-Processing/Word/Conversions/Word-To-Image/NET/Performance-metrics.md

@@ -0,0 +1,53 @@
+---
+title: Word to image Performance benchmark results | Syncfusion
+description: Explore the performance benchmark results of Word to image conversion using the .NET Word Library with different page counts
+platform: document-processing
+control: DocIO
+documentation: UG
+---
+
+# Word to image performance metrics in .NET Word Library
+
+The Syncfusion<sup>&reg;</sup> .NET Word library (DocIO) enables high-performance Word document processing, including conversion to images. This performance benchmark report highlights the speed and efficiency of Word to image conversion, demonstrating how our library performs across varying document sizes in real-world scenarios.
+
+## Environment
+
+The following system configurations were used for benchmarking:
+
+* **Operating System:** Windows 10  
+* **Processor:** 11th Gen Intel(R) Core(TM)  
+* **RAM:** 16GB  
+* **.NET Version:** .NET 8.0  
+* **Syncfusion<sup>&reg;</sup> Version:** [Syncfusion.DocIORenderer.Net.Core v31.1.17](https://www.nuget.org/packages/Syncfusion.DocIORenderer.Net.Core/31.1.17)
+
+## Word to image conversion
+
+<table>
+<tr>
+    <td><strong>Pages</strong></td>
+    <td><strong>Input Word File</strong></td>
+    <td><strong>Syncfusion<sup>&reg;</sup> Time (sec)</strong></td>
+</tr>
+<tr>
+    <td>2</td>
+    <td>{{'[Word-2.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Word-to-Image/.NET/Word-document-to-image/Word-document-to-image/Data/Document-2.docx)'| markdownify }}</td>
+    <td>0.77</td>
+</tr>
+<tr>
+    <td>50</td>
+    <td>{{'[Word-50.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Word-to-Image/.NET/Word-document-to-image/Word-document-to-image/Data/Document-50.docx)'| markdownify }}</td>
+    <td>9.6</td>
+</tr>
+<tr>
+    <td>100</td>
+    <td>{{'[Word-100.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Word-to-Image/.NET/Word-document-to-image/Word-document-to-image/Data/Document-100.docx)'| markdownify }}</td>
+    <td>13.9</td>
+</tr>
+<tr>
+    <td>500</td>
+    <td>{{'[Word-500.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Word-to-Image/.NET/Word-document-to-image/Word-document-to-image/Data/Document-500.docx)'| markdownify }}</td>
+    <td>49.8</td>
+</tr>
+</table>
+
+You can find the sample used for this performance evaluation on [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Performance-metrices/Word-to-Image).

Document-Processing/Word/Conversions/Word-To-PDF/NET/Performance-metrics.md

@@ -0,0 +1,53 @@
+---
+title: Word to PDF Performance benchmark results | Syncfusion
+description: Explore the performance benchmark results of Word to PDF conversion using the .NET Word Library with different page counts
+platform: document-processing
+control: DocIO
+documentation: UG
+---
+
+# Word to PDF performance benchmarks using .NET Word Library
+
+The Syncfusion<sup>&reg;</sup> .NET Word library (DocIO) enables high-performance Word document processing, including conversion to PDF. This performance benchmark report highlights the speed and efficiency of Word to PDF conversion, demonstrating how our library performs across varying document sizes in real-world scenarios.
+
+## Environment
+
+The following system configurations were used for benchmarking:
+
+* **Operating System:** Windows 10  
+* **Processor:** 11th Gen Intel(R) Core(TM)  
+* **RAM:** 16GB  
+* **.NET Version:** .NET 8.0  
+* **Syncfusion<sup>&reg;</sup> Version:** [Syncfusion.DocIORenderer.Net.Core v31.1.17](https://www.nuget.org/packages/Syncfusion.DocIORenderer.Net.Core/31.1.17)
+
+## Word to PDF conversion
+
+<table>
+<tr>
+    <td><strong>Pages</strong></td>
+    <td><strong>Input Word File</strong></td>
+    <td><strong>Syncfusion<sup>&reg;</sup> Time (sec)</strong></td>
+</tr>
+<tr>
+    <td>2</td>
+    <td>{{'[Word-2.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Word-to-PDF/.NET/Word-to-PDF/Word-to-PDF/Data/Document-2.docx)'| markdownify }}</td>
+    <td>1.3</td>
+</tr>
+<tr>
+    <td>50</td>
+    <td>{{'[Word-50.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Word-to-PDF/.NET/Word-to-PDF/Word-to-PDF/Data/Document-50.docx)'| markdownify }}</td>
+    <td>8.6</td>
+</tr>
+<tr>
+    <td>100</td>
+    <td>{{'[Word-100.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Word-to-PDF/.NET/Word-to-PDF/Word-to-PDF/Data/Document-100.docx)'| markdownify }}</td>
+    <td>14.2</td>
+</tr>
+<tr>
+    <td>500</td>
+    <td>{{'[Word-500.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Word-to-PDF/.NET/Word-to-PDF/Word-to-PDF/Data/Document-500.docx)'| markdownify }}</td>
+    <td>31.6</td>
+</tr>
+</table>
+
+You can find the sample used for this performance evaluation on [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Performance-metrices/Word-to-PDF).

Document-Processing/Word/Word-Library/NET/Performance-metrics.md

@@ -0,0 +1,86 @@
+---
+title: Word library Performance benchmark results | Syncfusion
+description: Know about the performance benchmark results of Syncfusion® .NET Word library with different document sizes
+platform: document-processing
+control: DocIO
+documentation: UG
+---
+
+# .NET Word library performance benchmarks
+
+The Syncfusion<sup>&reg;</sup> .NET Word library (DocIO) provides high-performance APIs to create, read, edit, and convert Word documents programmatically. This performance benchmark report highlights the speed and efficiency of key operations, demonstrating how DocIO handles large-scale document processing in real-world scenarios.
+
+## Environment
+
+The following system configurations were used for benchmarking:
+
+* **Operating System:** Windows 10  
+* **Processor:** 11th Gen Intel(R) Core(TM)  
+* **RAM:** 16GB  
+* **.NET Version:** .NET 8.0  
+* **Syncfusion<sup>&reg;</sup> Version:** [Syncfusion.DocIO.Net.Core v31.1.17](https://www.nuget.org/packages/Syncfusion.DocIO.Net.Core/31.1.17)
+
+## Open and save Word document
+
+<table>
+<tr>
+    <td><strong>Pages</strong></td>
+    <td><strong>Input Word File</strong></td>
+    <td><strong>Syncfusion<sup>&reg;</sup> Time (sec)</strong></td>
+</tr>
+<tr>
+    <td>2</td>
+    <td>{{'[Word-2.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Open-and-save/.NET/Open-and-Save-Word-document/Open-and-Save-Word-document/Data/Document-2.docx)'| markdownify }}</td>
+    <td>0.52</td>
+</tr>
+<tr>
+    <td>50</td>
+    <td>{{'[Word-50.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Open-and-save/.NET/Open-and-Save-Word-document/Open-and-Save-Word-document/Data/Document-50.docx)'| markdownify }}</td>
+    <td>1.3</td>
+</tr>
+<tr>
+    <td>100</td>
+    <td>{{'[Word-100.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Open-and-save/.NET/Open-and-Save-Word-document/Open-and-Save-Word-document/Data/Document-100.docx)'| markdownify }}</td>
+    <td>2.4</td>
+</tr>
+<tr>
+    <td>500</td>
+    <td>{{'[Word-500.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Open-and-save/.NET/Open-and-Save-Word-document/Open-and-Save-Word-document/Data/Document-500.docx)'| markdownify }}</td>
+    <td>4.7</td>
+</tr>
+</table>
+
+You can find the sample used for this performance evaluation on [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Performance-metrices/Open-and-save).
+
+## Clone and merge execution
+
+<table>
+<tr>
+    <td><strong>Pages</strong></td>
+    <td><strong>Input Word File</strong></td>
+    <td><strong>Syncfusion<sup>&reg;</sup> Time (sec)</strong></td>
+</tr>
+<tr>
+    <td>2</td>
+    <td>{{'[Word-2.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Clone-and-merge/.NET/Clone-and-merge-word-document/Clone-and-merge-word-document/Data/SourceDocument/Document-2.docx)'| markdownify }}</td>
+    <td>0.46</td>
+</tr>
+<tr>
+    <td>50</td>
+    <td>{{'[Word-50.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Clone-and-merge/.NET/Clone-and-merge-word-document/Clone-and-merge-word-document/Data/SourceDocument/Document-50.docx)'| markdownify }}</td>
+    <td>3.2</td>
+</tr>
+<tr>
+    <td>100</td>
+    <td>{{'[Word-100.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Clone-and-merge/.NET/Clone-and-merge-word-document/Clone-and-merge-word-document/Data/SourceDocument/Document-100.docx)'| markdownify }}</td>
+    <td>5.3</td>
+</tr>
+<tr>
+    <td>500</td>
+    <td>{{'[Word-500.docx](https://github.com/SyncfusionExamples/DocIO-Examples/blob/main/Performance-metrices/Clone-and-merge/.NET/Clone-and-merge-word-document/Clone-and-merge-word-document/Data/SourceDocument/Document-500.docx)'| markdownify }}</td>
+    <td>19.5</td>
+</tr>
+</table>
+
+You can find the sample used for this performance evaluation on [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Performance-metrices/Clone-and-merge).
+

Document-Processing/Word/Word-Library/NET/Working-with-Fields.md

@@ -25,6 +25,8 @@ From v16.1.0.24, the entire field code is included in Document Object Model(DOM)
 
 Find more information about migration changes [here](https://help.syncfusion.com/document-processing/release-notes/migratingtov16.1.0.24)
 
+N> The document may contain `IncludePicture` fields. These fields are designed to dynamically insert images by referencing external URLs. Each time such a field is encountered, the corresponding image is downloaded from the specified URL. This process significantly increases the time required to process and save the document. We recommend replacing these dynamic `IncludePicture` fields with standard image insertions. This approach eliminates the need for repeated external image downloads and allows the document to be saved in minimal time, ensuring optimal performance.
+
 ## Adding fields
 
 You can add a field to a Word document by using the [AppendField](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WParagraph.html#Syncfusion_DocIO_DLS_WParagraph_AppendField_System_String_Syncfusion_DocIO_FieldType_) method of [WParagraph](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WParagraph.html) class.
@@ -255,7 +257,7 @@ The following are the known limitations:
 * Updating of NUMPAGES field and Cross Reference field with Page number and Paragraph number options are not supported in Silverlight, WinRT, Universal, and Windows Phone applications.
 * Currently group shapes, drawing canvas, and table auto resizing are not supported in Word to PDF layouting, and this may lead to update incorrect page number and total number of pages.
 
-N> In ASP.NET Core, Blazor, Xamarin, WinUI and .NET MAUI platforms, to update fields like Page and NumPages in a Word document, pass true to the UpdateDocumentFields() method and reference the Word to PDF [assemblies](https://help.syncfusion.com/document-processing/word/word-library/net/assemblies-required#converting-word-document-to-pdf) or [NuGet](https://help.syncfusion.com/document-processing/word/word-library/net/nuget-packages-required#converting-word-document-to-pdf) packagesin your application.
+N> In ASP.NET Core, Blazor, Xamarin, WinUI and .NET MAUI platforms, to update fields like Page and NumPages in a Word document, pass true to the UpdateDocumentFields() method and reference the Word to PDF [assemblies](https://help.syncfusion.com/document-processing/word/word-library/net/assemblies-required#converting-word-document-to-pdf) or [NuGet](https://help.syncfusion.com/document-processing/word/word-library/net/nuget-packages-required#converting-word-document-to-pdf) packages in your application.
 
 The following code example explains how to update the fields present in Word document.