-
+
- 2025 Volume 2 - v30.*
- 2025 Volume 1 - v29.*
- 2024 Volume 4 - v28.*
- 2024 Volume 3 - v27.* diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img10.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img10.png new file mode 100644 index 000000000..970f8bd93 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img10.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img11.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img11.png new file mode 100644 index 000000000..34c03bf31 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img11.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img12.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img12.png new file mode 100644 index 000000000..8b5b8dc06 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img12.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img13.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img13.png new file mode 100644 index 000000000..2ae62582d Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img13.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img14.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img14.png new file mode 100644 index 000000000..5e9180fb2 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-Core_images/ASP-NET-Core_images_img14.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img10.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img10.png new file mode 100644 index 000000000..ef41c7241 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img10.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img11.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img11.png new file mode 100644 index 000000000..cf0da1ad6 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img11.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img12.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img12.png new file mode 100644 index 000000000..61f47bfe6 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img12.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img13.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img13.png new file mode 100644 index 000000000..5e9180fb2 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img13.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img9.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img9.png new file mode 100644 index 000000000..606cadc6e Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/ASP-NET-MVC_images/ASP-NET-MVC_images_img9.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img1.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img1.png new file mode 100644 index 000000000..96294cf28 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img1.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img2.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img2.png new file mode 100644 index 000000000..2f187e8d8 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img2.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img3.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img3.png new file mode 100644 index 000000000..1a7d7c346 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img3.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img4.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img4.png new file mode 100644 index 000000000..310aa532b Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img4.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img5.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img5.png new file mode 100644 index 000000000..03af5c6cf Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img5.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img6.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img6.png new file mode 100644 index 000000000..5e9180fb2 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Linux_images/Linux_images_img6.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img10.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img10.png new file mode 100644 index 000000000..d352c69cb Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img10.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img11.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img11.png new file mode 100644 index 000000000..527b98639 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img11.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img12.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img12.png new file mode 100644 index 000000000..c570a67d4 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img12.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img13.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img13.png new file mode 100644 index 000000000..acd1214e3 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img13.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img14.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img14.png new file mode 100644 index 000000000..bbbbed8cb Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img14.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img15.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img15.png new file mode 100644 index 000000000..5e9180fb2 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img15.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img9.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img9.png new file mode 100644 index 000000000..da9a9294d Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/MAUI_images/MAUI_images_img9.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img1.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img1.png new file mode 100644 index 000000000..96294cf28 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img1.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img2.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img2.png new file mode 100644 index 000000000..c40a68fce Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img2.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img3.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img3.png new file mode 100644 index 000000000..1a7d7c346 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img3.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img4.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img4.png new file mode 100644 index 000000000..23f13bee2 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img4.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img5.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img5.png new file mode 100644 index 000000000..310aa532b Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img5.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img6.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img6.png new file mode 100644 index 000000000..03af5c6cf Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img6.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img7.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img7.png new file mode 100644 index 000000000..bbbbed8cb Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img7.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img8.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img8.png new file mode 100644 index 000000000..5e9180fb2 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Mac_images/MacOS_images_img8.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img10.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img10.png new file mode 100644 index 000000000..65cc4a793 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img10.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img11.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img11.png new file mode 100644 index 000000000..5e9180fb2 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img11.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img8.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img8.png new file mode 100644 index 000000000..23f1ab149 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img8.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img9.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img9.png new file mode 100644 index 000000000..b845dcd05 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Windows-Forms_images/Windows-Forms_images_img9.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img10.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img10.png new file mode 100644 index 000000000..b029b840b Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img10.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img11.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img11.png new file mode 100644 index 000000000..5e9180fb2 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img11.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img8.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img8.png new file mode 100644 index 000000000..2ba8f4acd Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img8.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img9.png b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img9.png new file mode 100644 index 000000000..9761a1927 Binary files /dev/null and b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/Wpf_images/Wpf_images_img9.png differ diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-ASP-NET-Core.md b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-ASP-NET-Core.md new file mode 100644 index 000000000..4cbc8053c --- /dev/null +++ b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-ASP-NET-Core.md @@ -0,0 +1,197 @@ +--- +title: Convert Excel to Image in ASP.NET Core | Syncfusion +description: Convert Excel to image in ASP.NET Core using .NET Core Excel library (XlsIO) without Microsoft Excel or interop dependencies. +platform: document-processing +control: XlsIO +documentation: UG +--- + +# Convert Excel document to Image in ASP.NET Core + +Syncfusion® XlsIO is a [.NET Core Excel library](https://www.syncfusion.com/document-processing/excel-framework/net) used to create, read, edit and **convert Excel documents** programmatically without **Microsoft Excel** or interop dependencies. Using this library, you can **convert an Excel document to Image in ASP.NET Core**. + +## Steps to convert Excel document to Image in ASP.NET Core + +{% tabcontents %} + +{% tabcontent Visual Studio %} + +Step 1: Create a new ASP.NET Core Web application (Model-View-Controller) project. + + + +Step 2: Install the [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core) NuGet package as a reference to your project from [NuGet.org](https://www.nuget.org/). + + + +N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. + +Step 3: Include the following namespaces in the HomeController.cs file. + +{% tabs %} + +{% highlight c# tabtitle="C#" %} + +using Syncfusion.XlsIO; +using Syncfusion.XlsIORenderer; + +{% endhighlight %} + +{% endtabs %} + +Step 5: A default action method named Index will be present in HomeController.cs. Right click on Index method and select **Go To View** where you will be directed to its associated view page **Index.cshtml**. + +Step 6: Add a new button in the Index.cshtml as shown below. + +{% tabs %} + +{% highlight c# tabtitle="C#" %} + +@{ + Html.BeginForm("ConvertExceltoImage", "Home", FormMethod.Get); + { +
- Common Linux distributions such as Ubuntu, Alpine, CentOS, Debian, Fedora, and RHEL +
- Azure App Service +
- Google App Engine +
- AWS Lambda +
- AWS Elastic Beanstalk +
- Common Linux distributions such as Ubuntu, Alpine, CentOS, Debian, Fedora, and RHEL +
- Azure App Service +
- Google App Engine +
- AWS Lambda +
- AWS Elastic Beanstalk +
- Common Linux distributions such as Ubuntu, Alpine, CentOS, Debian, Fedora, and RHEL +
- Azure App Service +
- Google App Engine +
- AWS Lambda +
- AWS Elastic Beanstalk +
- Common Linux distributions such as Ubuntu, Alpine, CentOS, Debian, Fedora, and RHEL +
- Azure App Service +
- Google App Engine +
- AWS Lambda +
- AWS Elastic Beanstalk +
- Common Linux distributions such as Ubuntu, Alpine, CentOS, Debian, Fedora, and RHEL +
- Azure App Service +
- Google App Engine +
- AWS Lambda +
- AWS Elastic Beanstalk +
- Common Linux distributions such as Ubuntu, Alpine, CentOS, Debian, Fedora, and RHEL +
- Azure App Service +
- Google App Engine +
- AWS Lambda +
- AWS Elastic Beanstalk +
- ` tags in HTML when converting a Word document using DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/html-and-epub-conversions-faqs#how-to-preserve-li-tags-in-html-when-converting-a-word-document-using-docio) ## Linux @@ -116,6 +146,7 @@ The frequently asked questions under each category in Essential® * [How to perform Word to PDF in Linux prior to v18.4 release?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/linux-faqs#how-to-perform-word-to-pdf-in-linux-prior-to-v184-release) * [What are the NuGet packages to be installed to perform Word to PDF conversion in Linux OS?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/linux-faqs#what-are-the-nuget-packages-to-be-installed-to-perform-word-to-pdf-conversion-in-linux-os) * [What are the NuGet packages to be installed to perform Word to Image conversion in Linux OS?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/linux-faqs#what-are-the-nuget-packages-to-be-installed-to-perform-word-to-image-conversion-in-linux-os) +* [Why does SkiaSharp throw a type initializer exception in Azure Function on macOS?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/linux-faqs#why-does-skiasharp-throw-a-type-initializer-exception-in-azure-function-on-macos) ## Multithreading diff --git a/Document-Processing/Word/Word-Library/NET/FAQ_images/BoomarkName-with-hyphen.png b/Document-Processing/Word/Word-Library/NET/FAQ_images/BoomarkName-with-hyphen.png new file mode 100644 index 000000000..984198937 Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/FAQ_images/BoomarkName-with-hyphen.png differ diff --git a/Document-Processing/Word/Word-Library/NET/FAQ_images/Check-proofing-language.png b/Document-Processing/Word/Word-Library/NET/FAQ_images/Check-proofing-language.png new file mode 100644 index 000000000..2533d1b89 Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/FAQ_images/Check-proofing-language.png differ diff --git a/Document-Processing/Word/Word-Library/NET/FAQ_images/Corrupted-message.png b/Document-Processing/Word/Word-Library/NET/FAQ_images/Corrupted-message.png new file mode 100644 index 000000000..b6755aafe Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/FAQ_images/Corrupted-message.png differ diff --git a/Document-Processing/Word/Word-Library/NET/Lists_images/BulletListStyles.png b/Document-Processing/Word/Word-Library/NET/Lists_images/BulletListStyles.png new file mode 100644 index 000000000..a77982231 Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/Lists_images/BulletListStyles.png differ diff --git a/Document-Processing/Word/Word-Library/NET/Lists_images/ChangeListLevels.png b/Document-Processing/Word/Word-Library/NET/Lists_images/ChangeListLevels.png new file mode 100644 index 000000000..79c8a1164 Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/Lists_images/ChangeListLevels.png differ diff --git a/Document-Processing/Word/Word-Library/NET/Lists_images/CreateBulletedList.png b/Document-Processing/Word/Word-Library/NET/Lists_images/CreateBulletedList.png new file mode 100644 index 000000000..e028ba962 Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/Lists_images/CreateBulletedList.png differ diff --git a/Document-Processing/Word/Word-Library/NET/Lists_images/CreateNumberedList.png b/Document-Processing/Word/Word-Library/NET/Lists_images/CreateNumberedList.png new file mode 100644 index 000000000..8aadae0b5 Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/Lists_images/CreateNumberedList.png differ diff --git a/Document-Processing/Word/Word-Library/NET/Lists_images/ListNumberFormat.png b/Document-Processing/Word/Word-Library/NET/Lists_images/ListNumberFormat.png new file mode 100644 index 000000000..059df54c6 Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/Lists_images/ListNumberFormat.png differ diff --git a/Document-Processing/Word/Word-Library/NET/Lists_images/MultilevelBulletList.png b/Document-Processing/Word/Word-Library/NET/Lists_images/MultilevelBulletList.png new file mode 100644 index 000000000..e4182a2ae Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/Lists_images/MultilevelBulletList.png differ diff --git a/Document-Processing/Word/Word-Library/NET/Lists_images/MultilevelNumberedList.png b/Document-Processing/Word/Word-Library/NET/Lists_images/MultilevelNumberedList.png new file mode 100644 index 000000000..57e5721a8 Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/Lists_images/MultilevelNumberedList.png differ diff --git a/Document-Processing/Word/Word-Library/NET/Lists_images/NumberedListwithPrefix.png b/Document-Processing/Word/Word-Library/NET/Lists_images/NumberedListwithPrefix.png new file mode 100644 index 000000000..754b6a22f Binary files /dev/null and b/Document-Processing/Word/Word-Library/NET/Lists_images/NumberedListwithPrefix.png differ diff --git a/Document-Processing/Word/Word-Library/NET/NuGet-Packages-Required.md b/Document-Processing/Word/Word-Library/NET/NuGet-Packages-Required.md index 99a398c73..76f1a69d3 100644 --- a/Document-Processing/Word/Word-Library/NET/NuGet-Packages-Required.md +++ b/Document-Processing/Word/Word-Library/NET/NuGet-Packages-Required.md @@ -160,6 +160,7 @@ Install-Package Syncfusion.DocIO.AspNet N> 1. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. N> 2. Syncfusion® components are available in [nuget.org](https://www.nuget.org/) N> 3. Starting with v17.3.0.x, Syncfusion® provides support to .NET Core 3.0. You can use the above WPF or Windows Forms platform NuGet packages for .NET Core 3.0 targeting applications and use the same "C# tab" code examples for it. +N> 4. Syncfusion has **deprecated the ASP.NET package**. We strongly recommend upgrading your applications to ASP.NET Core. Refer [here](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/migrate-from-net-framework-to-net-core) to migrate from .NET Framework to .NET Core. ## Converting Word document to PDF @@ -272,6 +273,8 @@ Install-Package Syncfusion.DocIORenderer.NET
- Common Linux distributions such as Ubuntu, Alpine, CentOS, Debian, Fedora, and RHEL +
- Azure App Service +
- Google App Engine +
- AWS Lambda +
- AWS Elastic Beanstalk +
- Common Linux distributions such as Ubuntu, Alpine, CentOS, Debian, Fedora, and RHEL +
- Azure App Service +
- Google App Engine +
- AWS Lambda +
- AWS Elastic Beanstalk +
- ` tags in HTML when converting a Word document using DocIO?
+
+By default, DocIO exports list items as `
` tags in HTML, similar to Microsoft Word. To export them as proper `
- ` tags, disable Word compatibility using the [HTMLExportWithWordCompatibility](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.SaveOptions.html#Syncfusion_DocIO_DLS_SaveOptions_HTMLExportWithWordCompatibility) property. This ensures list items are preserved within `
- ` or `
- ` tags. + +{% tabs %} + +{% highlight c# tabtitle="C#" %} +document.SaveOptions.HTMLExportWithWordCompatibility = false; +{% endhighlight %} + +{% endtabs %} diff --git a/Document-Processing/Word/Word-Library/NET/faqs/linux-faqs.md b/Document-Processing/Word/Word-Library/NET/faqs/linux-faqs.md index a2ca76e89..93a0d89ae 100644 --- a/Document-Processing/Word/Word-Library/NET/faqs/linux-faqs.md +++ b/Document-Processing/Word/Word-Library/NET/faqs/linux-faqs.md @@ -312,3 +312,26 @@ From v20.2
- ` elements using `
+
+
+ }
+ Html.EndForm();
+}
+
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 7: Add a new action method **ConvertExceltoImage** in HomeController.cs and include the below code snippet to **convert the Excel document to image**.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+ FileStream excelStream = new FileStream("InputTemplate.xlsx", FileMode.Open, FileAccess.Read);
+ IWorkbook workbook = application.Workbooks.Open(excelStream);
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Initialize XlsIO renderer.
+ application.XlsIORenderer = new XlsIORenderer();
+
+ //Create the MemoryStream to save the image.
+ MemoryStream imageStream = new MemoryStream();
+
+ //Save the converted image to MemoryStream.
+ worksheet.ConvertToImage(worksheet.UsedRange, imageStream);
+ imageStream.Position = 0;
+
+ //Download image in the browser.
+ return File(imageStream, "application/jpeg", "Sample.jpeg");
+}
+
+{% endhighlight %}
+
+{% endtabs %}
+
+{% endtabcontent %}
+
+{% tabcontent Visual Studio Code %}
+
+Step 1: Create a new ASP.NET Core Web application project.
+* Open the command palette by pressing Ctrl+Shift+P and type **.NET:New Project** and enter.
+* Choose the **ASP.NET Core Web App( Model-View-Controller) MVC** template.
+
+
+
+* Select the project location, type the project name and press enter.
+* Then choose **Create project**.
+
+Step 2: To **convert a Excel document to image in ASP.NET Core Web app**, install [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core) to the ASP.NET Core project.
+* Press Ctrl + ` (backtick) to open the integrated terminal in Visual Studio Code.
+* Ensure you're in the project root directory where your .csproj file is located.
+* Run the command `dotnet add package Syncfusion.XlsIORenderer.Net.Core` to install the NuGet package.
+
+
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components.
+
+Step 3: Include the following namespaces in the HomeController.cs file.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+using Syncfusion.XlsIO;
+using Syncfusion.XlsIORenderer;
+
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 4: A default action method named Index will be present in HomeController.cs. Right click on Index method and select **Go To View** where you will be directed to its associated view page **Index.cshtml**.
+
+Step 5: Add a new button in the Index.cshtml as shown below.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+@{
+ Html.BeginForm("ConvertExceltoImage", "Home", FormMethod.Get);
+ {
+
+
+
+ }
+ Html.EndForm();
+}
+
+{% endhighlight %}
+
+{% endtabs %}
+
+Step 6: Add a new action method **ConvertExceltoImage** in HomeController.cs and include the below code snippet to **convert the Excel document to image**.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C#" %}
+
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+ FileStream excelStream = new FileStream("InputTemplate.xlsx", FileMode.Open, FileAccess.Read);
+ IWorkbook workbook = application.Workbooks.Open(excelStream);
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Initialize XlsIO renderer.
+ application.XlsIORenderer = new XlsIORenderer();
+
+ //Create the MemoryStream to save the image.
+ MemoryStream imageStream = new MemoryStream();
+
+ //Save the converted image to MemoryStream.
+ worksheet.ConvertToImage(worksheet.UsedRange, imageStream);
+ imageStream.Position = 0;
+
+ //Download image in the browser.
+ return File(imageStream, "application/jpeg", "Sample.jpeg");
+}
+
+{% endhighlight %}
+
+{% endtabs %}
+
+{% endtabcontent %}
+
+{% endtabcontents %}
+
+You can download a complete working sample from GitHub.
+
+By executing the program, you will get the **image** as follows.
+
+
+
+Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
+
+An online sample link to [convert an Excel document to Image](https://ej2.syncfusion.com/aspnetcore/Excel/WorksheetToImage#/material3) in ASP.NET Core.
\ No newline at end of file
diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-ASP-NET-MVC.md b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-ASP-NET-MVC.md
new file mode 100644
index 000000000..1e1e4220c
--- /dev/null
+++ b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-ASP-NET-MVC.md
@@ -0,0 +1,96 @@
+---
+title: Convert an Excel document to Image in ASP.NET MVC | Syncfusion
+description: Convert an Excel document to Image in ASP.NET MVC using Sycfusion .NET Excel library (XlsIO) without Microsoft Excel or interop dependencies.
+platform: document-processing
+control: XlsIO
+documentation: UG
+---
+
+# Convert an Excel document to Image in ASP.NET MVC
+
+Syncfusion® XlsIO is a [.NET Excel library](https://www.syncfusion.com/document-processing/excel-framework/net/excel-library) used to create, read, edit and **convert Excel documents** programmatically without **Microsoft Excel** or interop dependencies. Using this library, you can **convert an Excel document to Image in ASP.NET MVC**.
+
+## Steps to convert an Excel document to Image in ASP.NET MVC
+
+Step 1: Create a new ASP.NET Web Application Project.
+
+
+
+Step 2: Name the project, choose the framework and click **Create** button.
+
+
+
+Step 3: Select the MVC application.
+
+
+
+Step 4: Install the [Syncfusion.XlsIO.AspNet.Mvc5](https://www.nuget.org/packages/Syncfusion.XlsIO.AspNet.Mvc5) NuGet package as a reference to your project from [NuGet.org](https://www.nuget.org/).
+
+
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components.
+
+Step 5: Add a new button in the **Index.cshtml** as shown below.
+{% tabs %}
+{% highlight CSHTML %}
+@{Html.BeginForm("ConvertExceltoImage", "Home", FormMethod.Get);
+ {
+
+
+
+ }
+ Html.EndForm();
+}
+{% endhighlight %}
+{% endtabs %}
+
+Step 6: Include the following namespaces in **HomeController.cs**.
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using Syncfusion.XlsIO;
+{% endhighlight %}
+{% endtabs %}
+
+Step 7: Include the below code snippet in **HomeController.cs** to **convert an Excel document to Image**.
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+public void ConvertExcelToImage()
+{
+ using (ExcelEngine excelEngine = new ExcelEngine())
+ {
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+ FileStream excelStream = new FileStream("Sample.xlsx", FileMode.Open, FileAccess.Read);
+ IWorkbook workbook = application.Workbooks.Open(excelStream);
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Convert the Excel to Image
+ Image image = worksheet.ConvertToImage(1, 1, 20, 4);
+
+ //Save the image as jpeg
+ ExportAsImage(image, "ExcelToImage.Jpeg", ImageFormat.Jpeg, HttpContext.ApplicationInstance.Response);
+ }
+}
+
+protected void ExportAsImage(Image image, string fileName, ImageFormat imageFormat, HttpResponse response)
+{
+ if (ControllerContext == null)
+ throw new ArgumentNullException("Context");
+ string disposition = "content-disposition";
+ response.AddHeader(disposition, "attachment; filename=" + fileName);
+ if (imageFormat != ImageFormat.Emf)
+ image.Save(Response.OutputStream, imageFormat);
+ Response.End();
+}
+{% endhighlight %}
+{% endtabs %}
+
+You can download a complete working sample from GitHub.
+
+By executing the program, you will get the **image** as follows.
+
+
+
+Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
+
+An online sample link to [convert an Excel document to Image](https://ej2.syncfusion.com/aspnetcore/Excel/WorksheetToImage#/material3) in ASP.NET Core.
\ No newline at end of file
diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-Linux.md b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-Linux.md
new file mode 100644
index 000000000..5ef278ed4
--- /dev/null
+++ b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-Linux.md
@@ -0,0 +1,173 @@
+---
+title: Convert an Excel document to Image on Linux | Syncfusion
+description: Convert an Excel document to Image in .NET Core application on Linux using Syncfusion .NET Core Excel library (XlsIO) without Microsoft Office
+platform: document-processing
+control: XlsIO
+documentation: UG
+---
+# Convert an Excel document to Image on Linux
+
+Syncfusion® XlsIO is a [.NET Core Excel library](https://www.syncfusion.com/document-processing/excel-framework/net-core/excel-library) used to create, read, edit and **convert Excel documents** programmatically without **Microsoft Excel** or interop dependencies. Using this library, you can **convert an Excel document to Image on Linux**.
+
+## Steps to convert an Excel document to Image on Linux
+
+{% tabcontents %}
+
+{% tabcontent Visual Studio %}
+
+Step 1: Create a new C# .NET Core console application.
+
+
+Step 2: Name the project.
+
+
+
+Step 3: Select the framework and click **Create** button.
+
+
+
+Step 4: Install the following Nuget packages in your application from [NuGet.org](https://www.nuget.org/) by execute the following command.
+
+* [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core)
+* [SkiaSharp.NativeAssets.Linux](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)
+* [HarfBuzzSharp.NativeAssets.Linux](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.1.1)
+
+{% tabs %}
+{% highlight KCONFIG %}
+dotnet add package Syncfusion.XlsIORenderer.Net.Core -v 30.1.37 -s https://www.nuget.org/
+dotnet add package SkiaSharp.NativeAssets.Linux -v 3.116.1 -s https://www.nuget.org/
+dotnet add package HarfBuzzSharp.NativeAssets.Linux -v 8.3.1.1 -s https://www.nuget.org/
+{% endhighlight %}
+{% endtabs %}
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components.
+
+Step 5: Include the following Namespaces in the Program.cs file.
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using Syncfusion.XlsIO;
+using Syncfusion.XlsIORenderer;
+{% endhighlight %}
+{% endtabs %}
+
+Step 6: Add the following code snippet in Program.cs file.
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+ FileStream excelStream = new FileStream("Sample.xlsx", FileMode.Open, FileAccess.Read);
+ IWorkbook workbook = application.Workbooks.Open(excelStream);
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Initialize XlsIORenderer
+ application.XlsIORenderer = new XlsIORenderer();
+
+ //Create the MemoryStream to save the image
+ MemoryStream imageStream = new MemoryStream();
+
+ //Save the converted image to MemoryStream
+ worksheet.ConvertToImage(worksheet.UsedRange, imageStream);
+ imageStream.Position = 0;
+
+ #region Save
+ FileStream outputStream = new FileStream(Path.GetFullPath("Output/Sample.jpeg"), FileMode.Create, FileAccess.Write);
+ imageStream.CopyTo(outputStream);
+ #endregion
+
+ //Dispose streams
+ outputStream.Dispose();
+ excelStream.Dispose();
+}
+{% endhighlight %}
+{% endtabs %}
+
+{% endtabcontent %}
+
+{% tabcontent Visual Studio Code %}
+
+Step 1: Create a new C# .NET Core console application.
+
+
+Step 2: Name the project and create the project.
+
+
+
+Alternatively, create a ASP.NET Core console application using the following command in the terminal(Ctrl+`).
+
+```
+dotnet new console -o ConvertExcelToImage
+cd ConvertExcelToImage
+```
+
+Step 3: Install the following Nuget packages in your application from [NuGet.org](https://www.nuget.org/) by execute the following command.
+
+* [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core)
+* [SkiaSharp.NativeAssets.Linux](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)
+* [HarfBuzzSharp.NativeAssets.Linux](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.1.1)
+
+{% tabs %}
+{% highlight KCONFIG %}
+dotnet add package Syncfusion.XlsIORenderer.Net.Core -v 30.1.37 -s https://www.nuget.org/
+dotnet add package SkiaSharp.NativeAssets.Linux -v 3.116.1 -s https://www.nuget.org/
+dotnet add package HarfBuzzSharp.NativeAssets.Linux -v 8.3.1.1 -s https://www.nuget.org/
+{% endhighlight %}
+{% endtabs %}
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components.
+
+Step 4: Include the following Namespaces in the Program.cs file.
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using Syncfusion.XlsIO;
+using Syncfusion.XlsIORenderer;
+{% endhighlight %}
+{% endtabs %}
+
+Step 5: Add the following code snippet in Program.cs file.
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+ FileStream excelStream = new FileStream("Sample.xlsx", FileMode.Open, FileAccess.Read);
+ IWorkbook workbook = application.Workbooks.Open(excelStream);
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Initialize XlsIORenderer
+ application.XlsIORenderer = new XlsIORenderer();
+
+ //Create the MemoryStream to save the image
+ MemoryStream imageStream = new MemoryStream();
+
+ //Save the converted image to MemoryStream
+ worksheet.ConvertToImage(worksheet.UsedRange, imageStream);
+ imageStream.Position = 0;
+
+ #region Save
+ FileStream outputStream = new FileStream(Path.GetFullPath("Output/Sample.jpeg"), FileMode.Create, FileAccess.Write);
+ imageStream.CopyTo(outputStream);
+ #endregion
+
+ //Dispose streams
+ outputStream.Dispose();
+ excelStream.Dispose();
+}
+{% endhighlight %}
+{% endtabs %}
+
+{% endtabcontent %}
+
+{% endtabcontents %}
+
+You can download a complete working sample from this GitHub page.
+
+By executing the program, you will get the **Image** as follows.
+
+
+
+Click [here](https://www.syncfusion.com/document-processing/excel-framework/net) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
+
+An online sample link to [convert an Excel document to Image](https://ej2.syncfusion.com/aspnetcore/Excel/WorksheetToImage#/material3) in ASP.NET Core.
\ No newline at end of file
diff --git a/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-MAUI.md b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-MAUI.md
new file mode 100644
index 000000000..6337f4a02
--- /dev/null
+++ b/Document-Processing/Excel/Conversions/Excel-to-Image/NET/convert-excel-to-image-in-MAUI.md
@@ -0,0 +1,334 @@
+---
+title: Convert an Excel document to Image in .NET MAUI | Syncfusion
+description: Convert an Excel document to Image in .NET MAUI using .NET MAUI Excel library (XlsIO) without Microsoft Excel or interop dependencies.
+platform: document-processing
+control: XlsIO
+documentation: UG
+---
+
+# Convert Excel document to Image in .NET MAUI
+
+Syncfusion® XlsIO is a [.NET MAUI Excel library](https://www.syncfusion.com/document-processing/excel-framework/maui/excel-library) used to create, read, edit and **convert Excel documents** programmatically without **Microsoft Excel** or interop dependencies. Using this library, you can **convert an Excel document to Image in .NET MAUI**.
+
+## Prerequisites
+
+{% tabcontents %}
+
+{% tabcontent Visual Studio %}
+
+To create .NET Multi-platform App UI (.NET MAUI) apps, you need the latest versions of Visual Studio 2022 and .NET 8 or later. For more details, refer [here](https://learn.microsoft.com/en-us/dotnet/maui/get-started/installation?view=net-maui-7.0&tabs=vswin).
+
+{% endtabcontent %}
+
+{% tabcontent Visual Studio Code %}
+
+To create .NET Multi-platform App UI (.NET MAUI) apps using Visual Studio Code, you need the latest versions of the .NET 8 SDK and additional tools configured for .NET MAUI development. For more details, refer [here](https://learn.microsoft.com/en-us/dotnet/maui/get-started/installation?view=net-maui-7.0&tabs=vswin).
+
+{% endtabcontent %}
+
+{% endtabcontents %}
+
+## Steps to convert Excel document to Image in .NET MAUI
+
+{% tabcontents %}
+
+{% tabcontent Visual Studio %}
+
+Step 1: Create a new C# .NET MAUI application project.
+
+
+
+Step 2: Name the project and click **Next** button.
+
+
+
+Step 3: Install the [Syncfusion.XlsIORenderer.Net](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.NET) NuGet package as a reference to your project from [NuGet.org](https://www.nuget.org/).
+
+
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering a Syncfusion® license key in your application to use our components.
+
+Step 4: Add a new button to the **MainPage.xaml** as shown below.
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+
+| + Folder Name + | ++ File Name + | ++ Summary + | +
| + .NET MAUI Project + | ++ SaveService.cs + | ++ Represents the base class for save operation. + | +
| + Windows + | ++ SaveWindows.cs + | ++ Save implementation for Windows. + | +
| + Android + | ++ SaveAndroid.cs + | ++ Save implementation for Android device. + | +
| + Mac Catalyst + | ++ SaveMac.cs + | ++ Save implementation for Mac Catalyst device. + | +
| + iOS + | ++ SaveIOS.cs + | ++ Save implementation for iOS device. + | +
|
+ PreviewControllerDS.cs + QLPreviewItemFileSystem.cs + |
+ + Helper classes for viewing the Excel document on iOS device. + | +
+
+
+ }
+ Html.EndForm();
+}
+
+{% endhighlight %}
+{% endtabs %}
+
+Step 6: Include the below code snippet in the **Homecontroller.cs** file to **convert a Excel document to Pdf** and download it.
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+
+public IActionResult ConvertExceltoPDF()
+{
+ using (ExcelEngine excelEngine = new ExcelEngine())
+ {
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+
+ //Initializes the SubstituteFont event to perform font substitution during Excel-to-PDF conversion
+ application.SubstituteFont += new SubstituteFontEventHandler(SubstituteFont);
+
+ FileStream excelStream = new FileStream(@"Data/InputTemplate.xlsx", FileMode.Open, FileAccess.Read);
+ IWorkbook workbook = application.Workbooks.Open(excelStream);
+
+ //Initialize XlsIO renderer.
+ XlsIORenderer renderer = new XlsIORenderer();
+
+ //Convert Excel document into PDF document
+ PdfDocument pdfDocument = renderer.ConvertToPDF(workbook);
+
+ //Create the MemoryStream to save the converted PDF.
+ MemoryStream pdfStream = new MemoryStream();
+
+ //Save the converted PDF document to MemoryStream.
+ pdfDocument.Save(pdfStream);
+ pdfStream.Position = 0;
+ //Download PDF document in the browser
+ return File(pdfStream, "application/pdf", "Sample.pdf");
+ }
+}
+
+private static void SubstituteFont(object sender, SubstituteFontEventArgs args)
+{
+ string filePath = string.Empty;
+ FileStream fileStream = null;
+
+ if (args.OriginalFontName == "Calibri")
+ {
+ filePath = Path.GetFullPath(@"Data/calibri.ttf");
+ fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read);
+ args.AlternateFontStream = fileStream;
+ }
+}
+
+{% endhighlight %}
+{% endtabs %}
+
+## Steps to publish as AWS Elastic Beanstalk
+
+Step 1: Right-click the project and select **Publish to AWS Elastic Beanstalk (Legacy)** option.
+
+
+Step 2: Select the **Deployment Target** as **Create a new application environment** and click **Next** button.
+
+
+Step 3: Choose the **Environment Name** in the dropdown list and the **URL** will be automatically assign and check the URL is available, if available click next otherwise change the **URL**.
+
+
+Step 4: Select the instance type in **t3a.micro** from the dropdown list and click next.
+
+
+Step 5: Click the **Next** button to proceed further.
+
+
+Step 6: Click the **Next** button.
+
+
+Step 7: Click the **Deploy** button to deploy the sample on AWS Elastic Beanstalk.
+
+
+Step 8: After changing the status from **Updating** to **Environment is healthy**, click the **URL**.
+
+
+Step 9: After opening the provided **URL**, click **Convert ExceltoPDF** button to download the PDF document.
+
+
+You can download a complete working sample from [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Getting%20Started/AWS/AWS%20Elastic%20Beanstalk/ConvertExceltoPDF).
+
+By executing the program, you will get the **PDF document** as follows.
+
+
+
+Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
+
+An online sample link to [convert an Excel document to PDF](https://ej2.syncfusion.com/aspnetcore/Excel/ExcelToPDF#/material3) in ASP.NET Core.
\ No newline at end of file
diff --git a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-aws-lambda.md b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-aws-lambda.md
index 434c459e9..c430767ff 100644
--- a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-aws-lambda.md
+++ b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-aws-lambda.md
@@ -34,7 +34,9 @@ Step 4: Install the following **NuGet packages** in your application from [Nuget
-N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components.
+N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/excel/excel-library/net/nuget-packages-required#additional-nuget-packages-required-for-linux) for the required additional NuGet packages.
+
+N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components.
Step 5: Create a folder and copy the required data files and include the files to the project.
diff --git a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-azure-app-service-linux.md b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-azure-app-service-linux.md
index b3120af1d..b784c445f 100644
--- a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-azure-app-service-linux.md
+++ b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-azure-app-service-linux.md
@@ -34,7 +34,9 @@ Step 4: Install the following NuGet packages as reference to your project from [
-N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components.
+N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/excel/excel-library/net/nuget-packages-required#additional-nuget-packages-required-for-linux) for the required additional NuGet packages.
+
+N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components.
Step 5: Add a new button in the **Index.cshtml** as shown below.
{% tabs %}
diff --git a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-blazor.md b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-blazor.md
index 227f4a00a..4311f2abc 100644
--- a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-blazor.md
+++ b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-blazor.md
@@ -665,3 +665,225 @@ N> To convert Excel to PDF, it is necessary to access the font stream internally
Click [here](https://www.syncfusion.com/document-processing/excel-framework/blazor) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
An online sample link to [convert an Excel document to PDF](https://blazor.syncfusion.com/demos/excel/excel-to-pdf?theme=fluent) in Blazor.
+
+## Excel to PDF in .NET MAUI Blazor Hybrid App
+
+{% tabcontents %}
+
+{% tabcontent Visual Studio %}
+Step 1: Create a new C# .NET MAUI Blazor Hybrid Application project.
+
+
+
+Step 2: Name the project.
+
+
+
+Step 3: Select the framework and click **Create** button.
+
+
+
+Step 4: Install the following **Nuget packages** in your application from [NuGet.org](https://www.nuget.org/).
+* [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core)
+
+
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components.
+
+Step 5: Add a new button in **Pages/Home.razor**
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+@page "/"
+
+Convert Excel to PDF
+ + +{% endhighlight %} +{% endtabs %} + +Step 6: Include the following namespaces in the **Pages/Home.razor** file. + +{% tabs %} +{% highlight c# tabtitle="C#" %} +@using Syncfusion.XlsIO +@using Syncfusion.XlsIORenderer +@using Syncfusion.Pdf +@using System.IO +{% endhighlight %} +{% endtabs %} + +Step 7: Include the following code in the **Pages/Home.razor** file. + +{% tabs %} +{% highlight c# tabtitle="C#" %} + +@code { + private async Task ConvertExceltoPDF() + { + using ExcelEngine excelEngine = new(); + IApplication application = excelEngine.Excel; + application.DefaultVersion = ExcelVersion.Xlsx; + + string inputPath = Path.Combine(FileSystem.Current.AppDataDirectory, "InputTemplate.xlsx"); + + // Copy the Excel file from wwwroot to local app storage if it doesn't exist + if (!File.Exists(inputPath)) + { + using Stream resourceStream = await FileSystem.OpenAppPackageFileAsync("wwwroot/data/InputTemplate.xlsx"); + using FileStream outputStream = File.Create(inputPath); + await resourceStream.CopyToAsync(outputStream); + } + + using FileStream excelStream = File.OpenRead(inputPath); + IWorkbook workbook = application.Workbooks.Open(excelStream); + + XlsIORenderer renderer = new XlsIORenderer(); + PdfDocument pdf = renderer.ConvertToPDF(workbook); + + using MemoryStream stream = new(); + pdf.Save(stream); + pdf.Close(); + workbook.Close(); + + stream.Position = 0; + + // Save the generated PDF to local storage + + string outputDir = Path.Combine(FileSystem.Current.AppDataDirectory, "Output"); + + // Create folder if it doesn't exist + Directory.CreateDirectory(outputDir); + + string outputPath = Path.Combine(outputDir, "Sample.pdf"); + + using FileStream fileStream = new FileStream(outputPath, FileMode.Create, FileAccess.Write); + stream.CopyTo(fileStream); + await Application.Current.MainPage.DisplayAlert("Success", $"PDF saved to:\n{outputPath}", "OK"); + } +} +{% endhighlight %} +{% endtabs %} + +{% endtabcontent %} + +{% tabcontent Visual Studio Code %} + +Step 1: Create a new C# .NET MAUI Blazor Hybrid Application project. + + + +Step 2: Name the project and create the project. + + + +Alternatively, create a .NET MAUI Blazor Hybrid Application using the following command in the terminal(Ctrl+`). + +``` +dotnet new maui-blazor -n ConvertExcelToPdf +cd ConvertExcelToPdf +``` + +Step 3. To **convert an Excel document to PDF in Blazor**,run the following command to install [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core). + + +``` +dotnet add package Syncfusion.XlsIORenderer.Net.Core +``` + +N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. + +Step 4: Add a new button in **Pages/Home.razor** + +{% tabs %} +{% highlight c# tabtitle="C#" %} +@page "/" + +Convert Excel to PDF
+ + + +{% endhighlight %} +{% endtabs %} + +Step 5: Include the following namespaces in the **Pages/Home.razor** file. + +{% tabs %} +{% highlight c# tabtitle="C#" %} +@using Syncfusion.XlsIO +@using Syncfusion.XlsIORenderer +@using Syncfusion.Pdf +@using System.IO +{% endhighlight %} +{% endtabs %} + +Step 6: Include the following code in the **Pages/Home.razor** file. +{% tabs %} +{% highlight c# tabtitle="C#" %} + +@code { + private async Task ConvertExceltoPDF() + { + using ExcelEngine excelEngine = new(); + IApplication application = excelEngine.Excel; + application.DefaultVersion = ExcelVersion.Xlsx; + + string inputPath = Path.Combine(FileSystem.Current.AppDataDirectory, "InputTemplate.xlsx"); + + // Copy the Excel file from wwwroot to local app storage if it doesn't exist + if (!File.Exists(inputPath)) + { + using Stream resourceStream = await FileSystem.OpenAppPackageFileAsync("wwwroot/data/InputTemplate.xlsx"); + using FileStream outputStream = File.Create(inputPath); + await resourceStream.CopyToAsync(outputStream); + } + + using FileStream excelStream = File.OpenRead(inputPath); + IWorkbook workbook = application.Workbooks.Open(excelStream); + + XlsIORenderer renderer = new XlsIORenderer(); + PdfDocument pdf = renderer.ConvertToPDF(workbook); + + using MemoryStream stream = new(); + pdf.Save(stream); + pdf.Close(); + workbook.Close(); + + stream.Position = 0; + + // Save the generated PDF to local storage + + string outputDir = Path.Combine(FileSystem.Current.AppDataDirectory, "Output"); + + // Create folder if it doesn't exist + Directory.CreateDirectory(outputDir); + + string outputPath = Path.Combine(outputDir, "Sample.pdf"); + + // Save the PDF to a file + using (FileStream fileStream = new FileStream(outputPath, FileMode.Create, FileAccess.Write)) + { + stream.CopyTo(fileStream); + } + + // Display alert with the actual file path + await Application.Current.MainPage.DisplayAlert("Success", $"PDF saved to:\n{outputPath}", "OK"); + + } +} +{% endhighlight %} +{% endtabs %} + +{% endtabcontent %} + +{% endtabcontents %} + +A complete working example of how to convert an Excel document to PDF in .NET MAUI Blazor Hybrid App is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Getting%20Started/Blazor/MAUI/ExcelToPDF). + +By executing the program, you will get the **PDF document** as follows. + + + +Click [here](https://www.syncfusion.com/document-processing/excel-framework/blazor) to explore the rich set of Syncfusion® Excel library (XlsIO) features. + +An online sample link to [convert an Excel document to PDF](https://blazor.syncfusion.com/demos/excel/excel-to-pdf?theme=fluent) in Blazor. diff --git a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-console-application.md b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-console-application.md new file mode 100644 index 000000000..40f0aad4b --- /dev/null +++ b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-console-application.md @@ -0,0 +1,220 @@ +--- +title: Convert Excel to PDF in Console Application | Syncfusion +description: Convert Excel to PDF in Console application using Syncfusion .NET Core Excel library (XlsIO) without Microsoft Office +platform: document-processing +control: XlsIO +documentation: UG +--- + +# Convert Excel to PDF in Console application + +Syncfusion® XlsIO is a [.NET Core Excel library](https://www.syncfusion.com/document-processing/excel-framework/net-core/excel-library) used to create, read, edit and **convert Excel documents** programmatically without **Microsoft Excel** or interop dependencies. Using this library, you can **convert an Excel document to PDF in Console application**. + +## Convert Excel to PDF using .NET Core + +{% tabcontents %} + +{% tabcontent Visual Studio %} + +Step 1: Create a new C# .NET Core console application. + + +Step 2: Name the project. + + + +Step 3: Select the framework and click **Create** button. + + + +Step 4: Install the [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core) NuGet package as a reference to your project from [NuGet.org](https://www.nuget.org/). + + + +N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components. + +Step 5: Include the following Namespaces in the Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using Syncfusion.XlsIO; +using Syncfusion.XlsIORenderer; +using Syncfusion.Pdf; +{% endhighlight %} +{% endtabs %} + +Step 6: Add the following code snippet in Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using (ExcelEngine excelEngine = new ExcelEngine()) +{ + IApplication application = excelEngine.Excel; + application.DefaultVersion = ExcelVersion.Xlsx; + + //Load existing Excel file + FileStream inputStream = new FileStream(Path.GetFullPath(@"Data/Sample.xlsx"), FileMode.Open, FileAccess.Read); + IWorkbook workbook = application.Workbooks.Open(inputStream); + + //Convert to PDF + XlsIORenderer renderer = new XlsIORenderer(); + PdfDocument pdfDocument = renderer.ConvertToPDF(workbook); + + //Create the MemoryStream to save the converted PDF. + MemoryStream pdfStream = new MemoryStream(); + + #region Save + //Saving the workbook + FileStream outputStream = new FileStream(Path.GetFullPath("Output/Sample.pdf"), FileMode.Create, FileAccess.Write); + pdfDocument.Save(outputStream); + #endregion + + //Dispose streams + outputStream.Dispose(); + inputStream.Dispose(); +} +{% endhighlight %} +{% endtabs %} + +{% endtabcontent %} + +{% tabcontent Visual Studio Code %} + +Step 1: Create a new C# .NET Core console application. + + +Step 2: Name the project and create the project. + + + +Alternatively, create a ASP.NET Core console application using the following command in the terminal(Ctrl+`). + +``` +dotnet new console -o Convert-Excel-to-PDF +cd Convert-Excel-to-PDF +``` + +Step 3: To **Convert an Excel document to PDF in .NET Core app**, run the following command to install [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core) package. + + +``` +dotnet add package Syncfusion.XlsIORenderer.Net.Core +``` + +N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components. + +Step 4: Include the following Namespaces in the Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using Syncfusion.XlsIO; +using Syncfusion.XlsIORenderer; +using Syncfusion.Pdf; +{% endhighlight %} +{% endtabs %} + +Step 5: Add the following code snippet in Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using (ExcelEngine excelEngine = new ExcelEngine()) +{ + IApplication application = excelEngine.Excel; + application.DefaultVersion = ExcelVersion.Xlsx; + + //Load existing Excel file + FileStream inputStream = new FileStream(Path.GetFullPath(@"Data/Sample.xlsx"), FileMode.Open, FileAccess.Read); + IWorkbook workbook = application.Workbooks.Open(inputStream); + + //Convert to PDF + XlsIORenderer renderer = new XlsIORenderer(); + PdfDocument pdfDocument = renderer.ConvertToPDF(workbook); + + //Create the MemoryStream to save the converted PDF + MemoryStream pdfStream = new MemoryStream(); + + #region Save + //Saving the workbook + FileStream outputStream = new FileStream(Path.GetFullPath("Output/Sample.pdf"), FileMode.Create, FileAccess.Write); + pdfDocument.Save(outputStream); + #endregion + + //Dispose streams + outputStream.Dispose(); + inputStream.Dispose(); +} +{% endhighlight %} +{% endtabs %} + +{% endtabcontent %} + +{% endtabcontents %} + +A complete working example of how to convert an Excel document to PDF using .NET Core is present on this GitHub page. + +By executing the program, you will get the **PDF document** as follows. + + + +## Convert Excel to PDF using .NET Framework + +{% tabcontents %} + +{% tabcontent Visual Studio %} + +Step 1: Create a new C# .NET Framework console application. + + +Step 2: Name the project. + + + +Step 3: Install the [Syncfusion.ExcelToPdfConverter.WinForms](https://www.nuget.org/packages/Syncfusion.ExcelToPdfConverter.WinForms) NuGet package as a reference to your project from [NuGet.org](https://www.nuget.org/). + + + +N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components. + +Step 4: Include the following Namespaces in the Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using Syncfusion.XlsIO; +using Syncfusion.ExcelToPdfConverter; +using Syncfusion.Pdf; +{% endhighlight %} +{% endtabs %} + +Step 5: Add the following code snippet in Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using (ExcelEngine excelEngine = new ExcelEngine()) +{ + IApplication application = excelEngine.Excel; + application.DefaultVersion = ExcelVersion.Xlsx; + FileStream excelStream = new FileStream("Sample.xlsx", FileMode.Open, FileAccess.Read); + IWorkbook workbook = application.Workbooks.Open(excelStream); + + //Initialize ExcelToPdfConverter + ExcelToPdfConverter converter = new ExcelToPdfConverter(workbook); + + //Initialize PDF document + PdfDocument pdfDocument = new PdfDocument(); + + //Convert Excel document to PDF document + pdfDocument = converter.Convert(); + + //Save the converted PDF document + pdfDocument.Save("Sample.pdf"); +} +{% endhighlight %} +{% endtabs %} + +{% endtabcontent %} + +{% endtabcontents %} + +A complete working example of how to convert an Excel document to PDF using .NET Framework is present on this GitHub page. + +By executing the program, you will get the **PDF document** as follows. + + + +Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features. + +An online sample link to [convert an Excel document to PDF](https://ej2.syncfusion.com/aspnetcore/Excel/ExcelToPDF#/material3) in ASP.NET Core. \ No newline at end of file diff --git a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-docker.md b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-docker.md index 42637df09..e2e7d68d7 100644 --- a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-docker.md +++ b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-docker.md @@ -28,7 +28,9 @@ Step 3: Install the below NuGet packages as a reference to your project from [Nu   -N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/excel/excel-library/net/nuget-packages-required#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. + +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. Step 4: Include the following namespaces in the **Program.cs** file. diff --git a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-google-app-engine.md b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-google-app-engine.md index f1f472685..b98869b69 100644 --- a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-google-app-engine.md +++ b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-google-app-engine.md @@ -60,7 +60,9 @@ Step 4: Install the following **Nuget packages** in your application from [Nuget   -N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/excel/excel-library/net/nuget-packages-required#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. + +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. Step 5: Include the following namespaces in the **HomeController.cs** file. @@ -261,11 +263,11 @@ gcloud app deploy --version v0 {% endhighlight %} {% endtabs %} - + Step 2: Open the **URL** to access the application, which has been successfully deployed. - + A complete working example of how to convert an Excel document to PDF in GCP is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Getting%20Started/ASP.NET%20Core/Convert%20Excel%20to%20PDF). diff --git a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-linux.md b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-linux.md new file mode 100644 index 000000000..92d36638b --- /dev/null +++ b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-linux.md @@ -0,0 +1,172 @@ +--- +title: Convert an Excel document to PDF on Linux | Syncfusion +description: Convert an Excel document to PDF in .NET Core application on Linux using Syncfusion .NET Core Excel library (XlsIO) without Microsoft Office +platform: document-processing +control: XlsIO +documentation: UG +--- +# Convert an Excel document to PDF on Linux + +Syncfusion® XlsIO is a [.NET Core Excel library](https://www.syncfusion.com/document-processing/excel-framework/net-core/excel-library) used to create, read, edit and **convert Excel documents** programmatically without **Microsoft Excel** or interop dependencies. Using this library, you can **convert an Excel document to PDF on Linux**. + +## Steps to convert an Excel document to PDF on Linux + +{% tabcontents %} + +{% tabcontent Visual Studio %} + +Step 1: Create a new C# .NET Core console application. + + +Step 2: Name the project. + + + +Step 3: Select the framework and click **Create** button. + + + +Step 4: Install the following Nuget packages in your application from [NuGet.org](https://www.nuget.org/) by execute the following command. + +* [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core) +* [SkiaSharp.NativeAssets.Linux](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.119.0) +* [HarfBuzzSharp.NativeAssets.Linux](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.1.1) + +{% tabs %} +{% highlight KCONFIG %} +dotnet add package Syncfusion.XlsIO.Net.Core -v 29.1.41 -s https://www.nuget.org/ +dotnet add package SkiaSharp.NativeAssets.Linux -v 3.119.0 -s https://www.nuget.org/ +dotnet add package HarfBuzzSharp.NativeAssets.Linux -v 8.3.1.1 -s https://www.nuget.org/ +{% endhighlight %} +{% endtabs %} + +N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components. + +Step 5: Include the following Namespaces in the Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using Syncfusion.XlsIO; +using Syncfusion.XlsIORenderer; +using Syncfusion.Pdf; +{% endhighlight %} +{% endtabs %} + +Step 6: Add the following code snippet in Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using (ExcelEngine excelEngine = new ExcelEngine()) +{ + IApplication application = excelEngine.Excel; + application.DefaultVersion = ExcelVersion.Xlsx; + + //Load existing Excel file + FileStream inputStream = new FileStream(Path.GetFullPath(@"Data/Sample.xlsx"), FileMode.Open, FileAccess.Read); + IWorkbook workbook = application.Workbooks.Open(inputStream); + + //Convert to PDF + XlsIORenderer renderer = new XlsIORenderer(); + PdfDocument pdfDocument = renderer.ConvertToPDF(workbook); + + //Create the MemoryStream to save the converted PDF. + MemoryStream pdfStream = new MemoryStream(); + + #region Save + //Saving the workbook + FileStream outputStream = new FileStream(Path.GetFullPath("Output/Sample.pdf"), FileMode.Create, FileAccess.Write); + pdfDocument.Save(outputStream); + #endregion + + //Dispose streams + outputStream.Dispose(); + inputStream.Dispose(); +} +{% endhighlight %} +{% endtabs %} + +{% endtabcontent %} + +{% tabcontent Visual Studio Code %} + +Step 1: Create a new C# .NET Core console application. + + +Step 2: Name the project and create the project. + + + +Alternatively, create a ASP.NET Core console application using the following command in the terminal(Ctrl+`). + +``` +dotnet new console -o Convert-Excel-to-PDF +cd Convert-Excel-to-PDF +``` + +Step 3: Install the following Nuget packages in your application from [NuGet.org](https://www.nuget.org/) by execute the following command. + +* [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core) +* [SkiaSharp.NativeAssets.Linux](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.119.0) +* [HarfBuzzSharp.NativeAssets.Linux](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.1.1) + +{% tabs %} +{% highlight KCONFIG %} +dotnet add package Syncfusion.XlsIO.Net.Core -v 29.1.41 -s https://www.nuget.org/ +dotnet add package SkiaSharp.NativeAssets.Linux -v 3.119.0 -s https://www.nuget.org/ +dotnet add package HarfBuzzSharp.NativeAssets.Linux -v 8.3.1.1 -s https://www.nuget.org/ +{% endhighlight %} +{% endtabs %} + +N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components. + +Step 4: Include the following Namespaces in the Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using Syncfusion.XlsIO; +using Syncfusion.XlsIORenderer; +using Syncfusion.Pdf; +{% endhighlight %} +{% endtabs %} + +Step 5: Add the following code snippet in Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using (ExcelEngine excelEngine = new ExcelEngine()) +{ + IApplication application = excelEngine.Excel; + application.DefaultVersion = ExcelVersion.Xlsx; + + //Load existing Excel file + FileStream inputStream = new FileStream(Path.GetFullPath(@"Data/Sample.xlsx"), FileMode.Open, FileAccess.Read); + IWorkbook workbook = application.Workbooks.Open(inputStream); + + //Convert to PDF + XlsIORenderer renderer = new XlsIORenderer(); + PdfDocument pdfDocument = renderer.ConvertToPDF(workbook); + + //Create the MemoryStream to save the converted PDF. + MemoryStream pdfStream = new MemoryStream(); + + #region Save + //Saving the workbook + FileStream outputStream = new FileStream(Path.GetFullPath("Output/Sample.pdf"), FileMode.Create, FileAccess.Write); + pdfDocument.Save(outputStream); + #endregion + + //Dispose streams + outputStream.Dispose(); + inputStream.Dispose(); +} +{% endhighlight %} +{% endtabs %} + +{% endtabcontent %} + +{% endtabcontents %} +A complete working example of how to convert an Excel document to PDF on Linux is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Getting%20Started/Linux/Convert%20Excel%20to%20PDF). + +By executing the program, you will get the **PDF document** as follows. + + + +Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features. + +An online sample link to [convert an Excel document to PDF](https://ej2.syncfusion.com/aspnetcore/Excel/ExcelToPDF#/material3) in ASP.NET Core. diff --git a/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-mac.md b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-mac.md new file mode 100644 index 000000000..0e8b8b1f7 --- /dev/null +++ b/Document-Processing/Excel/Conversions/Excel-to-PDF/NET/convert-excel-to-pdf-in-mac.md @@ -0,0 +1,156 @@ +--- +title: Convert an Excel document to PDF on Mac | Syncfusion +description: Convert an Excel document to PDF on Mac using Syncfusion .NET Core Excel library (XlsIO) without Microsoft Office +platform: document-processing +control: XlsIO +documentation: UG +--- +# Convert an Excel document to PDF on Mac + +Syncfusion® XlsIO is a [.NET Core Excel library](https://www.syncfusion.com/document-processing/excel-framework/net-core/excel-library) used to create, read, edit and **convert Excel documents** programmatically without **Microsoft Excel** or interop dependencies. Using this library, you can **convert an Excel document to PDF on Mac**. + +## Steps to convert an Excel document to PDF on Mac + +{% tabcontents %} + +{% tabcontent Visual Studio %} + +Step 1: Create a new C# .NET Core console application. + + +Step 2: Name the project. + + + +Step 3: Select the framework and click **Create** button. + + + +Step 4: Install the [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core) NuGet package as a reference to your project from [NuGet.org](https://www.nuget.org/). + + + +N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components. + +Step 5: Include the following Namespaces in the Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using Syncfusion.XlsIO; +using Syncfusion.XlsIORenderer; +using Syncfusion.Pdf; +{% endhighlight %} +{% endtabs %} + +Step 6: Add the following code snippet in Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using (ExcelEngine excelEngine = new ExcelEngine()) +{ + IApplication application = excelEngine.Excel; + application.DefaultVersion = ExcelVersion.Xlsx; + + //Load existing Excel file + FileStream inputStream = new FileStream(Path.GetFullPath(@"Data/Sample.xlsx"), FileMode.Open, FileAccess.Read); + IWorkbook workbook = application.Workbooks.Open(inputStream); + + //Convert to PDF + XlsIORenderer renderer = new XlsIORenderer(); + PdfDocument pdfDocument = renderer.ConvertToPDF(workbook); + + //Create the MemoryStream to save the converted PDF. + MemoryStream pdfStream = new MemoryStream(); + + #region Save + //Saving the workbook + FileStream outputStream = new FileStream(Path.GetFullPath("Output/Sample.pdf"), FileMode.Create, FileAccess.Write); + pdfDocument.Save(outputStream); + #endregion + + //Dispose streams + outputStream.Dispose(); + inputStream.Dispose(); +} +{% endhighlight %} +{% endtabs %} + +{% endtabcontent %} + +{% tabcontent Visual Studio Code %} + +Step 1: Create a new C# .NET Core console application. + + +Step 2: Name the project and create the project. + + + +Alternatively, create a ASP.NET Core console application using the following command in the terminal(Ctrl+`). + +``` +dotnet new console -o Convert-Excel-to-PDF +cd Convert-Excel-to-PDF +``` + +Step 3: To **Convert an Excel document to PDF in .NET Core app**,run the following command to install [Syncfusion.XlsIORenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIORenderer.Net.Core) package. + + +``` +dotnet add package Syncfusion.XlsIORenderer.Net.Core +``` + +N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components. + +Step 4: Include the following Namespaces in the Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using Syncfusion.XlsIO; +using Syncfusion.XlsIORenderer; +using Syncfusion.Pdf; +{% endhighlight %} +{% endtabs %} + +Step 5: Add the following code snippet in Program.cs file. +{% tabs %} +{% highlight c# tabtitle="C#" %} +using (ExcelEngine excelEngine = new ExcelEngine()) +{ + IApplication application = excelEngine.Excel; + application.DefaultVersion = ExcelVersion.Xlsx; + + //Load existing Excel file + FileStream inputStream = new FileStream(Path.GetFullPath(@"Data/Sample.xlsx"), FileMode.Open, FileAccess.Read); + IWorkbook workbook = application.Workbooks.Open(inputStream); + + //Convert to PDF + XlsIORenderer renderer = new XlsIORenderer(); + PdfDocument pdfDocument = renderer.ConvertToPDF(workbook); + + //Create the MemoryStream to save the converted PDF. + MemoryStream pdfStream = new MemoryStream(); + + #region Save + //Saving the workbook + FileStream outputStream = new FileStream(Path.GetFullPath("Output/Sample.pdf"), FileMode.Create, FileAccess.Write); + pdfDocument.Save(outputStream); + #endregion + + //Dispose streams + outputStream.Dispose(); + inputStream.Dispose(); +} +{% endhighlight %} +{% endtabs %} + +{% endtabcontent %} + +{% endtabcontents %} + +A complete working example of how to convert an Excel document to PDF on Mac is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Getting%20Started/Mac/Convert%20Excel%20to%20PDF). + +By executing the program, you will get the **PDF document** as follows. + + + +Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features. + +An online sample link to [convert an Excel document to PDF](https://ej2.syncfusion.com/aspnetcore/Excel/ExcelToPDF#/material3) in ASP.NET Core. \ No newline at end of file diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img1.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img1.png new file mode 100644 index 000000000..74d727a1b Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img1.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img10.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img10.png new file mode 100644 index 000000000..52b683468 Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img10.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img11.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img11.png new file mode 100644 index 000000000..5558f06ba Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img11.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img12.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img12.png new file mode 100644 index 000000000..91075bbea Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img12.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img2.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img2.png new file mode 100644 index 000000000..f7b7911da Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img2.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img3.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img3.png new file mode 100644 index 000000000..38c2b7c2f Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img3.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img4.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img4.png new file mode 100644 index 000000000..e9da65e1a Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img4.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img5.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img5.png new file mode 100644 index 000000000..cfacbe2cf Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img5.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img6.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img6.png new file mode 100644 index 000000000..f6af51c71 Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img6.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img7.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img7.png new file mode 100644 index 000000000..77a193474 Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img7.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img8.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img8.png new file mode 100644 index 000000000..d610cbee6 Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img8.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img9.png b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img9.png new file mode 100644 index 000000000..3ca336b4f Binary files /dev/null and b/Document-Processing/Excel/Excel-Library/NET/AWS_Images/Elastic_Beanstalk_Images/Elastic_Beanstalk_img9.png differ diff --git a/Document-Processing/Excel/Excel-Library/NET/Assemblies-Required.md b/Document-Processing/Excel/Excel-Library/NET/Assemblies-Required.md index ced234d08..3a65c3659 100644 --- a/Document-Processing/Excel/Excel-Library/NET/Assemblies-Required.md +++ b/Document-Processing/Excel/Excel-Library/NET/Assemblies-Required.md @@ -62,6 +62,14 @@ Syncfusion.XlsIO.UWP Syncfusion.XlsIO.NET +|
+Amazon Web Services (AWS) |
+NuGet package name |
|---|---|
|
+AWS Lambda
+ |
+{{'[Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core)' | markdownify}} + |
+
+ +
+@Code
+ Html.EndForm()
+End Code
+{% endhighlight %}
{% endtabs %}
Step 7: Include the below code snippet in **HomeController.cs** to **load and save an Excel file and download it**.
@@ -87,6 +104,34 @@ using (ExcelEngine excelEngine = new ExcelEngine())
return File(outputStream, "application/msexcel", "Output.xlsx");
}
{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+'Create an instance of ExcelEngine
+Using excelEngine As New ExcelEngine()
+ Dim application As IApplication = excelEngine.Excel
+ application.DefaultVersion = ExcelVersion.Xlsx
+
+ 'Load an existing Excel document
+ Dim inputStream As New FileStream(Server.MapPath("~/Data/Input.xlsx"), FileMode.Open, FileAccess.Read)
+ Dim workbook As IWorkbook = application.Workbooks.Open(inputStream)
+
+ 'Access first worksheet
+ Dim worksheet As IWorksheet = workbook.Worksheets(0)
+
+ 'Set text in cell A3
+ worksheet.Range("A3").Text = "Hello World"
+
+ 'Save to memory stream
+ Dim outputStream As New MemoryStream()
+ workbook.SaveAs(outputStream)
+
+ 'Reset position
+ outputStream.Position = 0
+
+ 'Download the Excel document
+ Return File(outputStream, "application/msexcel", "Output.xlsx")
+End Using
+{% endhighlight %}
{% endtabs %}
## Steps to publish as Azure App Service on Windows
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-cloud-storage.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-cloud-storage.md
index 934670677..97e2333c1 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-cloud-storage.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-cloud-storage.md
@@ -210,7 +210,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
worksheet.Range["D5"].Text = "INVOICE#";
worksheet.Range["E5"].Text = "DATE";
worksheet.Range["D6"].Number = 1028;
- worksheet.Range["E6"].Value = "12/31/2018";
+ worksheet.SetValue(6, 5, "12/31/2018");
worksheet.Range["D7"].Text = "CUSTOMER ID";
worksheet.Range["E7"].Text = "TERMS";
worksheet.Range["D8"].Number = 564;
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v1.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v1.md
new file mode 100644
index 000000000..a096910f2
--- /dev/null
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v1.md
@@ -0,0 +1,174 @@
+---
+title: Loading and Saving Excel in Azure Functions v1 | Syncfusion
+description: Explains how to load and save an Excel files in Azure Functions v1 using Syncfusion Excel library.
+platform: document-processing
+control: XlsIO
+documentation: UG
+---
+# Loading and Saving Excel files in Azure Functions v1
+
+Syncfusion® XlsIO is a [.NET Excel library](https://www.syncfusion.com/document-processing/excel-framework/net) can be used to create, read, edit Excel files in Azure Functions v1.
+
+## Steps to Load and Save an Excel document in Azure Functions v1
+
+The below steps illustrates loading and saving a simple Invoice formatted Excel document in Azure Functions v1.
+
+Step 1: Create a new Azure Functions project.
+
+
+
+Step 2: Name the project.
+
+
+
+Step 3: Select the framework and click **Create** button.
+
+
+
+Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as reference to your .NET Standard applications from [NuGet.org](https://www.nuget.org).
+
+
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components.
+
+Step 5: Include the following namespaces in the Function1.cs file.
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using Syncfusion.XlsIO;
+{% endhighlight %}
+{% endtabs %}
+
+Step 6: Add the following code snippet in **Run** method of **Function1** class to perform **Loading and Saving Excel files** in Azure Functions v1.
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+
+ //Load an existing Excel document
+ FileStream inputStream = new FileStream("Data/InputTemplate.xlsx", FileMode.Open, FileAccess.Read);
+ IWorkbook workbook = application.Workbooks.Open(inputStream);
+
+ //Access first worksheet from the workbook
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Set Text in cell A3
+ worksheet.Range["A3"].Text = "Hello World";
+
+ MemoryStream outputStream = new MemoryStream();
+ workbook.SaveAs(outputStream);
+ outputStream.Position = 0;
+
+ //Set headers
+ response.Headers.Add("Content-Disposition", "attachment; filename=Output.xlsx");
+
+ //Set the content type as Excel document mime type
+ response.Headers.Add("Content-Type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
+
+ await response.Body.WriteAsync(outputStream.ToArray());
+
+ //Return the response with output Excel document stream
+ return response;
+}
+{% endhighlight %}
+{% endtabs %}
+
+Step 7: Right-click the project and select **Publish** option.
+
+
+
+Step 8: Select the publish target as **Azure**.
+
+
+
+Step 9: Select the Specific target as **Azure Function App (Windows)**.
+
+
+
+Step 10: Select the **Create new** button.
+
+
+
+Step 11: Click the **Create** button to proceed with creation.
+
+
+
+Step 12: Click the **Finish** button to finalize the **Azure Function** creation.
+
+
+
+Step 13: Click **Close** button.
+
+
+
+Step 14: Click the **Publish** button.
+
+
+
+Step 15: Publish has been succeeded.
+
+
+
+Step 16: Now, go to Azure portal and select the App Services. After running the service, click **Get function URL by copying it**. Then, paste it in the below client sample (which will request the Azure Functions, to perform **Loading and Saving Excel files** using the template Excel document). You will get the output Excel document as follows.
+
+
+
+## Steps to post the request to Azure Functions
+
+Step 1: Create a console application to request the Azure Functions API.
+
+Step 2: Add the following code snippet into **Main** method to post the request to Azure Functions with template Excel document and get the resultant Excel document.
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+//Reads the template Excel document.
+FileStream excelStream = new FileStream("../../Sample.xlsx", FileMode.Open, FileAccess.Read);
+excelStream.Position = 0;
+
+//Saves the Excel document in memory stream.
+MemoryStream inputStream = new MemoryStream();
+excelStream.CopyTo(inputStream);
+inputStream.Position = 0;
+
+try
+{
+ Console.WriteLine("Please enter your Azure Functions URL :");
+ string functionURL = Console.ReadLine();
+
+ //Create HttpWebRequest with hosted azure functions URL
+ HttpWebRequest req = (HttpWebRequest)WebRequest.Create(functionURL);
+
+ //Set request method as POST
+ req.Method = "POST";
+
+ //Get the request stream to save the Excel document stream
+ Stream stream = req.GetRequestStream();
+
+ //Write the Excel document stream into request stream
+ stream.Write(inputStream.ToArray(), 0, inputStream.ToArray().Length);
+
+ //Gets the responce from the Azure Functions
+ HttpWebResponse res = (HttpWebResponse)req.GetResponse();
+
+ //Saves the Excel stream
+ FileStream outStream = File.Create("Sample.xlsx");
+ res.GetResponseStream().CopyTo(outStream);
+
+ //Dispose the streams
+ inputStream.Dispose();
+ outStream.Dispose();
+}
+catch (Exception ex)
+{
+ throw;
+}
+{% endhighlight %}
+{% endtabs %}
+
+A complete working example of how to load and save an Excel document in Azure Functions v1 in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Loading%20and%20Saving/Azure/Azure%20Functions%20v1/Loading%20and%20Saving).
+
+Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
+
+An online sample link to [create an Excel document](https://ej2.syncfusion.com/aspnetcore/Excel/Create#/material3) in ASP.NET Core.
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v4.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v4.md
new file mode 100644
index 000000000..124a989cb
--- /dev/null
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-azure-functions-v4.md
@@ -0,0 +1,174 @@
+---
+title: Loading and Saving Excel in Azure Functions v4 | Syncfusion
+description: Explains how to load and save an Excel files in Azure Functions v4 using Syncfusion Excel library.
+platform: document-processing
+control: XlsIO
+documentation: UG
+---
+# Loading and Saving Excel files in Azure Functions v4
+
+Syncfusion® XlsIO is a [.NET Excel library](https://www.syncfusion.com/document-processing/excel-framework/net) can be used to create, read, edit Excel files in Azure Functions v4.
+
+## Steps to Load and Save an Excel document in Azure Functions v4
+
+The below steps illustrates loading and saving a simple Invoice formatted Excel document in Azure Functions v4.
+
+Step 1: Create a new Azure Functions project.
+
+
+
+Step 2: Name the project.
+
+
+
+Step 3: Select the framework and click **Create** button.
+
+
+
+Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as reference to your .NET Standard applications from [NuGet.org](https://www.nuget.org).
+
+
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components.
+
+Step 5: Include the following namespaces in the Function1.cs file.
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using Syncfusion.XlsIO;
+{% endhighlight %}
+{% endtabs %}
+
+Step 6: Add the following code snippet in **Run** method of **Function1** class to perform **Loading and Saving Excel files** in Azure Functions v4.
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+
+ //Load an existing Excel document
+ FileStream inputStream = new FileStream("Data/InputTemplate.xlsx", FileMode.Open, FileAccess.Read);
+ IWorkbook workbook = application.Workbooks.Open(inputStream);
+
+ //Access first worksheet from the workbook
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Set Text in cell A3
+ worksheet.Range["A3"].Text = "Hello World";
+
+ MemoryStream outputStream = new MemoryStream();
+ workbook.SaveAs(outputStream);
+ outputStream.Position = 0;
+
+ //Set headers
+ response.Headers.Add("Content-Disposition", "attachment; filename=Output.xlsx");
+
+ //Set the content type as Excel document mime type
+ response.Headers.Add("Content-Type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
+
+ await response.Body.WriteAsync(outputStream.ToArray());
+
+ //Return the response with output Excel document stream
+ return response;
+}
+{% endhighlight %}
+{% endtabs %}
+
+Step 7: Right-click the project and select **Publish** option.
+
+
+
+Step 8: Select the publish target as **Azure**.
+
+
+
+Step 9: Select the Specific target as **Azure Function App (Windows)**.
+
+
+
+Step 10: Select the **Create new** button.
+
+
+
+Step 11: Click the **Create** button to proceed with creation.
+
+
+
+Step 12: Click the **Finish** button to finalize the **Azure Function** creation.
+
+
+
+Step 13: Click **Close** button.
+
+
+
+Step 14: Click the **Publish** button.
+
+
+
+Step 15: Publish has been succeeded.
+
+
+
+Step 16: Now, go to Azure portal and select the App Services. After running the service, click **Get function URL by copying it**. Then, paste it in the below client sample (which will request the Azure Functions, to perform **Loading and Saving Excel files** using the template Excel document). You will get the output Excel document as follows.
+
+
+
+## Steps to post the request to Azure Functions
+
+Step 1: Create a console application to request the Azure Functions API.
+
+Step 2: Add the following code snippet into **Main** method to post the request to Azure Functions with template Excel document and get the resultant Excel document.
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+//Reads the template Excel document.
+FileStream excelStream = new FileStream("../../Sample.xlsx", FileMode.Open, FileAccess.Read);
+excelStream.Position = 0;
+
+//Saves the Excel document in memory stream.
+MemoryStream inputStream = new MemoryStream();
+excelStream.CopyTo(inputStream);
+inputStream.Position = 0;
+
+try
+{
+ Console.WriteLine("Please enter your Azure Functions URL :");
+ string functionURL = Console.ReadLine();
+
+ //Create HttpWebRequest with hosted azure functions URL
+ HttpWebRequest req = (HttpWebRequest)WebRequest.Create(functionURL);
+
+ //Set request method as POST
+ req.Method = "POST";
+
+ //Get the request stream to save the Excel document stream
+ Stream stream = req.GetRequestStream();
+
+ //Write the Excel document stream into request stream
+ stream.Write(inputStream.ToArray(), 0, inputStream.ToArray().Length);
+
+ //Gets the responce from the Azure Functions
+ HttpWebResponse res = (HttpWebResponse)req.GetResponse();
+
+ //Saves the Excel stream
+ FileStream outStream = File.Create("Sample.xlsx");
+ res.GetResponseStream().CopyTo(outStream);
+
+ //Dispose the streams
+ inputStream.Dispose();
+ outStream.Dispose();
+}
+catch (Exception ex)
+{
+ throw;
+}
+{% endhighlight %}
+{% endtabs %}
+
+A complete working example of how to load and save an Excel document in Azure Functions v4 in C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Loading%20and%20Saving/Azure/Azure%20Functions%20v4/Loading%20and%20Saving).
+
+Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
+
+An online sample link to [create an Excel document](https://ej2.syncfusion.com/aspnetcore/Excel/Create#/material3) in ASP.NET Core.
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-drop-box-cloud-storage.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-drop-box-cloud-storage.md
index a2f8a899b..efb0e5237 100644
--- a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-drop-box-cloud-storage.md
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-drop-box-cloud-storage.md
@@ -217,7 +217,7 @@ using (ExcelEngine excelEngine = new ExcelEngine())
worksheet.Range["D5"].Text = "INVOICE#";
worksheet.Range["E5"].Text = "DATE";
worksheet.Range["D6"].Number = 1028;
- worksheet.Range["E6"].Value = "12/31/2018";
+ worksheet.SetValue(6, 5, "12/31/2018");
worksheet.Range["D7"].Text = "CUSTOMER ID";
worksheet.Range["E7"].Text = "TERMS";
worksheet.Range["D8"].Number = 564;
diff --git a/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-google-app-engine.md b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-google-app-engine.md
new file mode 100644
index 000000000..290311aae
--- /dev/null
+++ b/Document-Processing/Excel/Excel-Library/NET/Loading-and-Saving/loading-and-saving-excel-files-in-google-app-engine.md
@@ -0,0 +1,258 @@
+---
+title: Loading and Saving Excel in GCP | Syncfusion
+description: Explains how to load and save an Excel files in Google App Engine using .NET Core Excel (XlsIO) library without Microsoft Excel or interop dependencies.
+platform: document-processing
+control: XlsIO
+documentation: UG
+---
+
+# Loading and Saving Excel files in Google App Engine
+
+Syncfusion® XlsIO is a [.NET Core Excel library](https://www.syncfusion.com/document-processing/excel-framework/net-core) used to create, read, edit and convert Excel documents programmatically without **Microsoft Excel** or interop dependencies. Using this library, you can **load and save an Excel document in Google App Engine**.
+
+## Set up App Engine
+
+Step 1: Open the **Google Cloud Console** and click the **Activate Cloud Shell** button.
+
+
+Step 2: Click the **Cloud Shell Editor** button to view the **Workspace**.
+
+
+Step 3: Open **Cloud Shell Terminal**, run the following **command** to confirm authentication.
+
+{% tabs %}
+{% highlight c# tabtitle="CLI" %}
+
+gcloud auth list
+
+{% endhighlight %}
+{% endtabs %}
+
+
+
+Step 4: Click the **Authorize** button.
+
+
+## Create an application for App Engine
+
+Step 1: Open Visual Studio and select the ASP.NET Core Web app (Model-View-Controller) template.
+
+
+Step 2: Configure your new project according to your requirements.
+
+
+Step 3: Click the **Create** button.
+
+
+Step 4: Install the [Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core) NuGet package as a reference to your project from [NuGet.org](https://www.nuget.org).
+
+
+
+N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components.
+
+Step 5: Include the following namespaces in the **HomeController.cs** file.
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+
+using Syncfusion.XlsIO;
+
+{% endhighlight %}
+{% endtabs %}
+
+Step 6: A default action method named Index will be present in HomeController.cs. Right click on Index method and select **Go To View** where you will be directed to its associated view page **Index.cshtml**.
+
+Step 7: Add a new button in the Index.cshtml as shown below.
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+
+@{
+ Html.BeginForm("LoadAndSaveDocument", "Home", FormMethod.Get);
+ {
+ + +
+
+
+ }
+ Html.EndForm();
+}
+
+{% endhighlight %}
+{% endtabs %}
+
+Step 8: Add a new action method **LoadAndSaveDocument** in HomeController.cs and include the below code snippet to **load and save an existing Excel document**.
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+
+ //Load an existing Excel document
+ FileStream inputStream = new FileStream("Data/InputTemplate.xlsx", FileMode.Open, FileAccess.Read);
+ IWorkbook workbook = application.Workbooks.Open(inputStream);
+
+ //Access first worksheet from the workbook.
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Set Text in cell A3.
+ worksheet.Range["A3"].Text = "Hello World";
+
+ //Save the Excel to MemoryStream
+ MemoryStream outputStream = new MemoryStream();
+ workbook.SaveAs(outputStream);
+
+ //Set the position
+ outputStream.Position = 0;
+
+ //Download the Excel document in the browser.
+ return File(outputStream, "application/msexcel", "Sample.xlsx");
+}
+{% endhighlight %}
+{% endtabs %}
+
+## Move application to App Engine
+
+Step 1: Open the **Cloud Shell editor**.
+
+
+Step 2: Drag and drop the sample from your local machine to **Workspace**.
+
+
+N> If you have your sample application in your local machine, drag and drop it into the Workspace. If you created the sample using the Cloud Shell terminal command, it will be available in the Workspace.
+
+Step 3: Open the Cloud Shell Terminal and run the following **command** to view the files and directories within your **current Workspace**.
+
+{% tabs %}
+{% highlight c# tabtitle="CLI" %}
+
+ls
+
+{% endhighlight %}
+{% endtabs %}
+
+
+
+Step 4: Run the following **command** to navigate which sample you want run.
+
+{% tabs %}
+{% highlight c# tabtitle="CLI" %}
+
+cd LoadingandSaving
+
+{% endhighlight %}
+{% endtabs %}
+
+
+
+Step 5: To ensure that the sample is working correctly, please run the application using the following command.
+
+{% tabs %}
+{% highlight c# tabtitle="CLI" %}
+
+dotnet run --urls=http://localhost:8080
+
+{% endhighlight %}
+{% endtabs %}
+
+
+
+Step 6: Verify that the application is running properly by accessing the **Web View** -> **Preview on port 8080**.
+
+
+Step 7: Now you can see the sample output on the preview page.
+
+
+Step 8: Close the preview page and return to the terminal then press **Ctrl+C** for which will typically stop the process.
+
+
+## Publish the application
+
+Step 1: Run the following command in **Cloud Shell Terminal** to publish the application.
+
+{% tabs %}
+{% highlight c# tabtitle="CLI" %}
+
+dotnet publish -c Release
+
+{% endhighlight %}
+{% endtabs %}
+
+
+
+Step 2: Run the following command in **Cloud Shell Terminal** to navigate to the publish folder.
+{% tabs %}
+{% highlight c# tabtitle="CLI" %}
+
+cd bin/Release/net8.0/publish/
+
+{% endhighlight %}
+{% endtabs %}
+
+
+
+## Configure app.yaml and docker file
+
+Step 1: Add the app.yaml file to the publish folder with the following contents.
+
+{% tabs %}
+{% highlight c# tabtitle="CLI" %}
+
+cat <|
+Google Cloud Platform |
+NuGet package name |
|---|---|
|
+App Engine
+ |
+{{'[Syncfusion.XlsIO.Net.Core](https://www.nuget.org/packages/Syncfusion.XlsIO.Net.Core)' | markdownify}} + |
| +Required Native assets NuGet packages + | ++Applicable Linux environments + | +
|---|---|
|
+{{'[SkiaSharp.NativeAssets.Linux v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)' | markdownify}} {{'[HarfBuzzSharp.NativeAssets.Linux v8.3.0.1](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.0.1)' | markdownify}} + |
+
+Azure App Service +Google App Engine + |
+
| +{{'[SkiaSharp.NativeAssets.Linux.NoDependencies v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/3.116.1)' | markdownify}} + | +
+AWS Lambda +AWS Elastic Beanstalk + |
+
| Option | +Description | +
|---|---|
| ExcelSheetProtection.DeletingRows | +Allows users to delete entire rows when the worksheet is protected. The deletion is only possible if the rows contain only unlocked cells. | +
| ExcelSheetProtection.DeletingColumns | +Allows users to delete entire columns in a protected worksheet. The operation is permitted only if the columns consist entirely of unlocked cells. | +
| ExcelSheetProtection.InsertingRows | +Permits the insertion of new rows into areas with unlocked cells. | +
| ExcelSheetProtection.InsertingColumns | +Permits the insertion of new columns into areas with unlocked cells. | +
| ExcelSheetProtection.InsertingHyperlinks | +Allows the user to insert hyperlinks into unlocked cells. | +
| ExcelSheetProtection.FormattingCells | +Enables formatting of unlocked cells (e.g., fonts, number formats) while the sheet is protected. | +
| ExcelSheetProtection.FormattingColumns | +Allows formatting of entire columns even when the sheet is protected. | +
| ExcelSheetProtection.FormattingRows | +Allows formatting of entire rows even when the sheet is protected. | +
| ExcelSheetProtection.Objects | +Prevents editing or deletion of objects like charts, shapes, or images on the sheet. | +
| ExcelSheetProtection.Scenarios | +Protects defined scenarios from modification or deletion. | +
| ExcelSheetProtection.Sorting | +Enables sorting functionality in a protected worksheet, assuming all cells involved are unlocked. | +
| ExcelSheetProtection.Filtering | +Allows filtering of data using AutoFilter drop-downs while the sheet is protected. | +
| ExcelSheetProtection.UsingPivotTables | +Enables users to interact with PivotTables (e.g., refresh or rearrange) in a protected sheet. | +
| ExcelSheetProtection.LockedCells | +Applies protection to all locked cells. Users cannot modify these cells unless unlocked or explicitly permitted. | +
| ExcelSheetProtection.UnLockedCells | +Specifies that users are allowed to edit unlocked cells even when the worksheet is protected. | +
| ExcelSheetProtection.Content | +Prevents editing of any content on the worksheet unless specific permissions are granted. | +
| ExcelSheetProtection.All | +Applies all protection options available for the worksheet, including locking cells, disabling formatting, insertion, deletion, etc. | +
+
+
+ }
+ Html.EndForm();
+}
+
+{% endhighlight %}
+{% endtabs %}
+
+Step 6: Add a new action method **CreateExcelDocument** in HomeController.cs and include the below code snippet to **create an Excel document** and download it.
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+//Create an instance of ExcelEngine
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+
+ //Create a workbook
+ IWorkbook workbook = application.Workbooks.Create(1);
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Adding a picture
+ FileStream imageStream = new FileStream("AdventureCycles-Logo.png", FileMode.Open, FileAccess.Read);
+ IPictureShape shape = worksheet.Pictures.AddPicture(1, 1, imageStream, 20, 20);
+
+ //Disable gridlines in the worksheet
+ worksheet.IsGridLinesVisible = false;
+
+ //Enter values to the cells from A3 to A5
+ worksheet.Range["A3"].Text = "46036 Michigan Ave";
+ worksheet.Range["A4"].Text = "Canton, USA";
+ worksheet.Range["A5"].Text = "Phone: +1 231-231-2310";
+
+ //Make the text bold
+ worksheet.Range["A3:A5"].CellStyle.Font.Bold = true;
+
+ //Merge cells
+ worksheet.Range["D1:E1"].Merge();
+
+ //Enter text to the cell D1 and apply formatting.
+ worksheet.Range["D1"].Text = "INVOICE";
+ worksheet.Range["D1"].CellStyle.Font.Bold = true;
+ worksheet.Range["D1"].CellStyle.Font.RGBColor = Color.FromArgb(42, 118, 189);
+ worksheet.Range["D1"].CellStyle.Font.Size = 35;
+
+ //Apply alignment in the cell D1
+ worksheet.Range["D1"].CellStyle.HorizontalAlignment = ExcelHAlign.HAlignRight;
+ worksheet.Range["D1"].CellStyle.VerticalAlignment = ExcelVAlign.VAlignTop;
+
+ //Enter values to the cells from D5 to E8
+ worksheet.Range["D5"].Text = "INVOICE#";
+ worksheet.Range["E5"].Text = "DATE";
+ worksheet.Range["D6"].Number = 1028;
+ worksheet.Range["E6"].Value = "12/31/2018";
+ worksheet.Range["D7"].Text = "CUSTOMER ID";
+ worksheet.Range["E7"].Text = "TERMS";
+ worksheet.Range["D8"].Number = 564;
+ worksheet.Range["E8"].Text = "Due Upon Receipt";
+
+ //Apply RGB backcolor to the cells from D5 to E8
+ worksheet.Range["D5:E5"].CellStyle.Color = Color.FromArgb(42, 118, 189);
+ worksheet.Range["D7:E7"].CellStyle.Color = Color.FromArgb(42, 118, 189);
+
+ //Apply known colors to the text in cells D5 to E8
+ worksheet.Range["D5:E5"].CellStyle.Font.Color = ExcelKnownColors.White;
+ worksheet.Range["D7:E7"].CellStyle.Font.Color = ExcelKnownColors.White;
+
+ //Make the text as bold from D5 to E8
+ worksheet.Range["D5:E8"].CellStyle.Font.Bold = true;
+
+ //Apply alignment to the cells from D5 to E8
+ worksheet.Range["D5:E8"].CellStyle.HorizontalAlignment = ExcelHAlign.HAlignCenter;
+ worksheet.Range["D5:E5"].CellStyle.VerticalAlignment = ExcelVAlign.VAlignCenter;
+ worksheet.Range["D7:E7"].CellStyle.VerticalAlignment = ExcelVAlign.VAlignCenter;
+ worksheet.Range["D6:E6"].CellStyle.VerticalAlignment = ExcelVAlign.VAlignTop;
+
+ //Enter value and applying formatting in the cell A7
+ worksheet.Range["A7"].Text = " BILL TO";
+ worksheet.Range["A7"].CellStyle.Color = Color.FromArgb(42, 118, 189);
+ worksheet.Range["A7"].CellStyle.Font.Bold = true;
+ worksheet.Range["A7"].CellStyle.Font.Color = ExcelKnownColors.White;
+
+ //Apply alignment
+ worksheet.Range["A7"].CellStyle.HorizontalAlignment = ExcelHAlign.HAlignLeft;
+ worksheet.Range["A7"].CellStyle.VerticalAlignment = ExcelVAlign.VAlignCenter;
+
+ //Enter values in the cells A8 to A12
+ worksheet.Range["A8"].Text = "Steyn";
+ worksheet.Range["A9"].Text = "Great Lakes Food Market";
+ worksheet.Range["A10"].Text = "20 Whitehall Rd";
+ worksheet.Range["A11"].Text = "North Muskegon,USA";
+ worksheet.Range["A12"].Text = "+1 231-654-0000";
+
+ //Create a Hyperlink for e-mail in the cell A13
+ IHyperLink hyperlink = worksheet.HyperLinks.Add(worksheet.Range["A13"]);
+ hyperlink.Type = ExcelHyperLinkType.Url;
+ hyperlink.Address = "Steyn@greatlakes.com";
+ hyperlink.ScreenTip = "Send Mail";
+
+ //Merge column A and B from row 15 to 22
+ worksheet.Range["A15:B15"].Merge();
+ worksheet.Range["A16:B16"].Merge();
+ worksheet.Range["A17:B17"].Merge();
+ worksheet.Range["A18:B18"].Merge();
+ worksheet.Range["A19:B19"].Merge();
+ worksheet.Range["A20:B20"].Merge();
+ worksheet.Range["A21:B21"].Merge();
+ worksheet.Range["A22:B22"].Merge();
+
+ //Enter details of products and prices
+ worksheet.Range["A15"].Text = " DESCRIPTION";
+ worksheet.Range["C15"].Text = "QTY";
+ worksheet.Range["D15"].Text = "UNIT PRICE";
+ worksheet.Range["E15"].Text = "AMOUNT";
+ worksheet.Range["A16"].Text = "Cabrales Cheese";
+ worksheet.Range["A17"].Text = "Chocos";
+ worksheet.Range["A18"].Text = "Pasta";
+ worksheet.Range["A19"].Text = "Cereals";
+ worksheet.Range["A20"].Text = "Ice Cream";
+ worksheet.Range["C16"].Number = 3;
+ worksheet.Range["C17"].Number = 2;
+ worksheet.Range["C18"].Number = 1;
+ worksheet.Range["C19"].Number = 4;
+ worksheet.Range["C20"].Number = 3;
+ worksheet.Range["D16"].Number = 21;
+ worksheet.Range["D17"].Number = 54;
+ worksheet.Range["D18"].Number = 10;
+ worksheet.Range["D19"].Number = 20;
+ worksheet.Range["D20"].Number = 30;
+ worksheet.Range["D23"].Text = "Total";
+
+ //Apply number format
+ worksheet.Range["D16:E22"].NumberFormat = "$0.00";
+ worksheet.Range["E23"].NumberFormat = "$0.00";
+
+ //Apply incremental formula for column Amount by multiplying Qty and UnitPrice
+ application.EnableIncrementalFormula = true;
+ worksheet.Range["E16:E20"].Formula = "=C16*D16";
+
+ //Formula for Sum the total
+ worksheet.Range["E23"].Formula = "=SUM(E16:E22)";
+
+ //Apply borders
+ worksheet.Range["A16:E22"].CellStyle.Borders[ExcelBordersIndex.EdgeTop].LineStyle = ExcelLineStyle.Thin;
+ worksheet.Range["A16:E22"].CellStyle.Borders[ExcelBordersIndex.EdgeBottom].LineStyle = ExcelLineStyle.Thin;
+ worksheet.Range["A16:E22"].CellStyle.Borders[ExcelBordersIndex.EdgeTop].Color = ExcelKnownColors.Grey_25_percent;
+ worksheet.Range["A16:E22"].CellStyle.Borders[ExcelBordersIndex.EdgeBottom].Color = ExcelKnownColors.Grey_25_percent;
+ worksheet.Range["A23:E23"].CellStyle.Borders[ExcelBordersIndex.EdgeTop].LineStyle = ExcelLineStyle.Thin;
+ worksheet.Range["A23:E23"].CellStyle.Borders[ExcelBordersIndex.EdgeBottom].LineStyle = ExcelLineStyle.Thin;
+ worksheet.Range["A23:E23"].CellStyle.Borders[ExcelBordersIndex.EdgeTop].Color = ExcelKnownColors.Black;
+ worksheet.Range["A23:E23"].CellStyle.Borders[ExcelBordersIndex.EdgeBottom].Color = ExcelKnownColors.Black;
+
+ //Apply font setting for cells with product details
+ worksheet.Range["A3:E23"].CellStyle.Font.FontName = "Arial";
+ worksheet.Range["A3:E23"].CellStyle.Font.Size = 10;
+ worksheet.Range["A15:E15"].CellStyle.Font.Color = ExcelKnownColors.White;
+ worksheet.Range["A15:E15"].CellStyle.Font.Bold = true;
+ worksheet.Range["D23:E23"].CellStyle.Font.Bold = true;
+
+ //Apply cell color
+ worksheet.Range["A15:E15"].CellStyle.Color = Color.FromArgb(42, 118, 189);
+
+ //Apply alignment to cells with product details
+ worksheet.Range["A15"].CellStyle.HorizontalAlignment = ExcelHAlign.HAlignLeft;
+ worksheet.Range["C15:C22"].CellStyle.HorizontalAlignment = ExcelHAlign.HAlignCenter;
+ worksheet.Range["D15:E15"].CellStyle.HorizontalAlignment = ExcelHAlign.HAlignCenter;
+
+ //Apply row height and column width to look good
+ worksheet.Range["A1"].ColumnWidth = 36;
+ worksheet.Range["B1"].ColumnWidth = 11;
+ worksheet.Range["C1"].ColumnWidth = 8;
+ worksheet.Range["D1:E1"].ColumnWidth = 18;
+ worksheet.Range["A1"].RowHeight = 47;
+ worksheet.Range["A2"].RowHeight = 15;
+ worksheet.Range["A3:A4"].RowHeight = 15;
+ worksheet.Range["A5"].RowHeight = 18;
+ worksheet.Range["A6"].RowHeight = 29;
+ worksheet.Range["A7"].RowHeight = 18;
+ worksheet.Range["A8"].RowHeight = 15;
+ worksheet.Range["A9:A14"].RowHeight = 15;
+ worksheet.Range["A15:A23"].RowHeight = 18;
+
+ //Saving the Excel to the MemoryStream
+ MemoryStream stream = new MemoryStream();
+ workbook.SaveAs(stream);
+
+ //Set the position as '0'.
+ stream.Position = 0;
+
+ //Download Excel document in the browser.
+ return File(stream.ToArray(), "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Sample.xlsx");
+}
+
+{% endhighlight %}
+{% endtabs %}
+
+## Steps to publish as AWS Elastic Beanstalk
+
+Step 1: Right-click the project and select **Publish to AWS Elastic Beanstalk (Legacy)** option.
+
+
+Step 2: Select the **Deployment Target** as **Create a new application environment** and click **Next** button.
+
+
+Step 3: Choose the **Environment Name** in the dropdown list and the **URL** will be automatically assign and check the URL is available, if available click next otherwise change the **URL**.
+
+
+Step 4: Select the instance type in **t3a.micro** from the dropdown list and click next.
+
+
+Step 5: Click the **Next** button to proceed further.
+
+
+Step 6: Click the **Next** button.
+
+
+Step 7: Click the **Deploy** button to deploy the sample on AWS Elastic Beanstalk.
+
+
+Step 8: After changing the status from **Updating** to **Environment is healthy**, click the **URL**.
+
+
+Step 9: After opening the provided **URL**, click **Create Document** button to download the Excel document.
+
+
+You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Getting%20Started/AWS/AWS%20Elastic%20Beanstalk/Create%20Excel).
+
+By executing the program, you will get the **Excel document** as follows.
+
+
+
+## Read and Edit Excel file
+
+The below code snippet illustrates how to read and edit an Excel file in AWS Elastic Beanstalk.
+
+{% tabs %}
+{% highlight c# tabtitle="C#" %}
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ //Instantiate the Excel application object
+ IApplication application = excelEngine.Excel;
+
+ //Assigns default application version
+ application.DefaultVersion = ExcelVersion.Xlsx;
+
+ //A existing workbook is opened.
+ FileStream sampleFile = new FileStream("Data/InputTemplate.xlsx", FileMode.Open);
+ IWorkbook workbook = application.Workbooks.Open(sampleFile);
+
+ //Access first worksheet from the workbook.
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Set Text in cell A3.
+ worksheet.Range["A3"].Text = "Hello World";
+ //Saving the Excel to the MemoryStream
+ MemoryStream stream = new MemoryStream();
+ workbook.SaveAs(stream);
+
+ //Set the position as '0'.
+ stream.Position = 0;
+
+ //Download Excel document in the browser.
+ return File(stream.ToArray(), "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "Sample.xlsx");
+}
+
+{% endhighlight %}
+{% endtabs %}
+
+You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/Getting%20Started/AWS/AWS%20Elastic%20Beanstalk/EditExcel).
+
+Click [here](https://www.syncfusion.com/document-processing/excel-framework/net-core) to explore the rich set of Syncfusion® Excel library (XlsIO) features.
+
+An online sample link to [create an Excel document](https://ej2.syncfusion.com/aspnetcore/Excel/Create#/material3) in ASP.NET Core.
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/faqs/does-xlsio-support-converting-an-empty-Excel-document-to-PDF.md b/Document-Processing/Excel/Excel-Library/NET/faqs/does-xlsio-support-converting-an-empty-Excel-document-to-PDF.md
new file mode 100644
index 000000000..502188ce1
--- /dev/null
+++ b/Document-Processing/Excel/Excel-Library/NET/faqs/does-xlsio-support-converting-an-empty-Excel-document-to-PDF.md
@@ -0,0 +1,11 @@
+---
+title: Convert an empty Excel document to PDF using XlsIO | Syncfusion
+description: Learn whether Syncfusion XlsIO supports converting an empty Excel document to PDF.
+platform: document-processing
+control: XlsIO
+documentation: UG
+---
+
+# Does XlsIO support converting an empty Excel document to PDF?
+
+Yes. XlsIO allows you to convert an empty Excel document to PDF.
diff --git a/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-add-oval-shape-to-Excel-chart.md b/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-add-oval-shape-to-Excel-chart.md
new file mode 100644
index 000000000..822e446b1
--- /dev/null
+++ b/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-add-oval-shape-to-Excel-chart.md
@@ -0,0 +1,99 @@
+---
+title: How to add Oval shape to Excel chart using XlsIO | Syncfusion
+description: Code example to add Oval shape to Excel chart using Syncfusion .NET Excel library (XlsIO).
+platform: document-processing
+control: XlsIO
+documentation: UG
+---
+
+# How to add Oval shape to Excel chart using XlsIO?
+
+The following code snippets illustrate how to add Oval shape to Excel chart in C# (cross-platform and Windows-specific) and VB.NET.
+
+{% tabs %}
+{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/FAQ/Add%20oval%20shape%20to%20chart/.NET/Add%20oval%20shape%20to%20chart/Add%20oval%20shape%20to%20chart/Program.cs,180" %}
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+ IWorkbook workbook = application.Workbooks.Create(1);
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Add chart to worksheet
+ IChart chart = worksheet.Charts.Add();
+
+ //Add oval shape to chart
+ IShape shape = chart.Shapes.AddAutoShapes(AutoShapeType.Oval, 20, 60, 500, 400);
+
+ //Format the shape
+ shape.Line.ForeColorIndex = ExcelKnownColors.Red;
+
+ //Add the text to the oval shape and set the text alignment on the shape
+ shape.TextFrame.TextRange.Text = "This is an oval shape";
+ shape.TextFrame.VerticalAlignment = ExcelVerticalAlignment.MiddleCentered;
+ shape.TextFrame.HorizontalAlignment = ExcelHorizontalAlignment.CenterMiddle;
+
+ #region Save
+ //Saving the workbook
+ FileStream outputStream = new FileStream(Path.GetFullPath("Output.xlsx"), FileMode.Create, FileAccess.Write);
+ workbook.SaveAs(outputStream);
+ #endregion
+
+ //Dispose streams
+ outputStream.Dispose();
+}
+{% endhighlight %}
+
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+ IWorkbook workbook = application.Workbooks.Create(1);
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ //Add chart to worksheet
+ IChart chart = worksheet.Charts.Add();
+
+ //Add oval shape to chart
+ IShape shape = chart.Shapes.AddAutoShapes(AutoShapeType.Oval, 20, 60, 500, 400);
+
+ //Format the shape
+ shape.Line.ForeColorIndex = ExcelKnownColors.Red;
+
+ //Add the text to the oval shape and set the text alignment on the shape
+ shape.TextFrame.TextRange.Text = "This is an oval shape";
+ shape.TextFrame.VerticalAlignment = ExcelVerticalAlignment.MiddleCentered;
+ shape.TextFrame.HorizontalAlignment = ExcelHorizontalAlignment.CenterMiddle;
+
+ workbook.SaveAs("Output.xlsx");
+}
+{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+Using excelEngine As New ExcelEngine()
+ Dim application As IApplication = excelEngine.Excel
+ application.DefaultVersion = ExcelVersion.Xlsx
+ Dim workbook As IWorkbook = application.Workbooks.Create(1)
+ Dim worksheet As IWorksheet = workbook.Worksheets(0)
+
+ 'Add chart to worksheet
+ Dim chart As IChart = worksheet.Charts.Add()
+
+ 'Add oval shape to chart
+ Dim shape As IShape = chart.Shapes.AddAutoShapes(AutoShapeType.Oval, 20, 60, 500, 400)
+
+ 'Format the shape
+ shape.Line.ForeColorIndex = ExcelKnownColors.Red
+
+ 'Add the text to the oval shape and set the text alignment on the shape
+ shape.TextFrame.TextRange.Text = "This is an oval shape"
+ shape.TextFrame.VerticalAlignment = ExcelVerticalAlignment.MiddleCentered
+ shape.TextFrame.HorizontalAlignment = ExcelHorizontalAlignment.CenterMiddle
+
+ workbook.SaveAs("Output.xlsx")
+End Using
+{% endhighlight %}
+{% endtabs %}
+
+A complete working example to add Oval shape to Excel chart using C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/FAQ/Add%20oval%20shape%20to%20chart/.NET/Add%20oval%20shape%20to%20chart).
\ No newline at end of file
diff --git a/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-apply-TimePeriod-conditional-formatting-in-Excel.md b/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-apply-TimePeriod-conditional-formatting-in-Excel.md
index f3f4d2a82..84d12a1f9 100644
--- a/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-apply-TimePeriod-conditional-formatting-in-Excel.md
+++ b/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-apply-TimePeriod-conditional-formatting-in-Excel.md
@@ -1,5 +1,5 @@
---
-title: How to apply TimePeriod conditional formatting in Excel using C# | Syncfusion
+title: How to apply TimePeriod conditional formatting in Excel | Syncfusion
description: Code example to apply TimePeriod-based conditional formatting in an Excel document using Syncfusion .NET Excel library (XlsIO).
platform: document-processing
control: XlsIO
@@ -13,7 +13,7 @@ You can apply TimePeriod-based conditional formatting in an Excel worksheet usin
The following examples show how to highlight cells that match specific time periods in C# (cross-platform and Windows-specific) and VB.NET.
{% tabs %}
-{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink= "https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/FAQ/Conditional%20Formatting/.NET/Time%20period/Time%20period/Program.cs,180" %}
+{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/FAQ/Conditional%20Formatting/.NET/Time%20period/Time%20period/Program.cs,180" %}
using (ExcelEngine excelEngine = new ExcelEngine())
{
IApplication application = excelEngine.Excel;
diff --git a/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-apply-rotation-and-transparency-to-background-image.md b/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-apply-rotation-and-transparency-to-background-image.md
index f2a0c5dbf..390cdca26 100644
--- a/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-apply-rotation-and-transparency-to-background-image.md
+++ b/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-apply-rotation-and-transparency-to-background-image.md
@@ -1,5 +1,5 @@
---
-title: How to apply rotation and transparency to background image | XlsIO | Syncfusion
+title: How to set rotation and transparency to background images | Syncfusion
description: This page explains how to apply rotation and transparency to background image using Syncfusion .NET Excel library (XlsIO).
platform: document-processing
control: XlsIO
diff --git a/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-avoid-processing-unnecessary-worksheets-when-opening-an-Excel-document.md b/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-avoid-processing-unnecessary-worksheets-when-opening-an-Excel-document.md
new file mode 100644
index 000000000..8e53defaa
--- /dev/null
+++ b/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-avoid-processing-unnecessary-worksheets-when-opening-an-Excel-document.md
@@ -0,0 +1,66 @@
+---
+title: Avoid loading unused worksheets when opening Excel | Syncfusion
+description: Code example to avoid processing unnecessary worksheets when opening an Excel document using Syncfusion .NET Excel library (XlsIO).
+platform: document-processing
+control: XlsIO
+documentation: UG
+---
+# How to avoid processing unnecessary worksheets when opening an Excel document using C#?
+XlsIO provides support to avoid processing unnecessary worksheets when opening an Excel. The following code snippet illustrates this.
+{% tabs %}
+{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/FAQ/Worksheet/.NET/Parse%20Worksheets%20On%20Demand/Parse%20Worksheets%20On%20Demand/Program.cs,180" %}
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+ FileStream inputStream = new FileStream("Input.xlsx", FileMode.Open, FileAccess.Read);
+ IWorkbook workbook = application.Workbooks.Open(inputStream,ExcelOpenType.Automatic, ExcelParseOptions.ParseWorksheetsOnDemand);
+
+ // Access the first worksheet (triggers parsing)
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ // Process your data
+ string value = worksheet.Range["A1"].Text;
+
+ // Save to file system
+ FileStream stream = new FileStream("Output.xlsx", FileMode.OpenOrCreate, FileAccess.ReadWrite);
+ workbook.SaveAs(stream);
+ workbook.Close();
+ excelEngine.Dispose();
+}
+{% endhighlight %}
+
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+using (ExcelEngine excelEngine = new ExcelEngine())
+{
+ IApplication application = excelEngine.Excel;
+ application.DefaultVersion = ExcelVersion.Xlsx;
+ IWorkbook workbook = application.Workbooks.Open("Input.xlsx",ExcelOpenType.Automatic,ExcelParseOptions.ParseWorksheetsOnDemand);
+
+ // Access the first worksheet (triggers parsing)
+ IWorksheet worksheet = workbook.Worksheets[0];
+
+ // Process your data
+ string value = worksheet.Range["A1"].Text;
+ workbook.SaveAs("Output.xlsx");
+}
+{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+ Using excelEngine As ExcelEngine = New ExcelEngine()
+ Dim application As IApplication = excelEngine.Excel
+ application.DefaultVersion = ExcelVersion.Xlsx
+ Dim workbook As IWorkbook = application.Workbooks.Open("Input.xlsx", ExcelParseOptions.ParseWorksheetsOnDemand)
+
+ ' Access the first worksheet (triggers parsing)
+ Dim worksheet As IWorksheet = workbook.Worksheets(0)
+
+ ' Process your data...
+ Dim value As String = worksheet.Range("A1").Text
+
+ workbook.SaveAs("Output.xlsx")
+ End Using
+{% endhighlight %}
+{% endtabs %}
+
+A complete working example to avoid processing unnecessary worksheets when opening an Excel document using C# is present on [this GitHub page](https://github.com/SyncfusionExamples/XlsIO-Examples/tree/master/FAQ/Worksheet/.NET/Parse%20Worksheets%20On%20Demand).
diff --git a/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-convert-json-document-to-csv-format-document.md b/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-convert-json-document-to-csv-format-document.md
new file mode 100644
index 000000000..c31c32918
--- /dev/null
+++ b/Document-Processing/Excel/Excel-Library/NET/faqs/how-to-convert-json-document-to-csv-format-document.md
@@ -0,0 +1,88 @@
+---
+title: How to convert JSON document to CSV format document |Syncfusion.
+description: This page explains how to convert JSON document to CSV format document using Syncfusion .NET Excel library (XlsIO).
+platform: document-processing
+control: XlsIO
+documentation: UG
+---
+
+# How to convert JSON document to CSV format document?
+
+The following code illustrates how to convert JSON document to CSV format document.
+
+{% tabs %}
+{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/XlsIO-Examples/master/FAQ/Conversions/.NET/JSON%20to%20CSV/JSON%20to%20CSV/Program.cs,180" %}
+//Load JSON file
+string jsonPath = Path.GetFullPath("Data/Input.json");
+string jsonData = File.ReadAllText(jsonPath);
+
+//Deserialize to DataTable
+DataTable dataTable = JsonConvert.DeserializeObjectHello world
"); + return new FileStreamResult(new MemoryStream(pdfBytes), "application/pdf"); } - catch(Exception ex) + catch (Exception ex) { - //Create a new PDF document. - document = new PdfDocument(); - //Add a page to the document. - PdfPage page = document.Pages.Add(); - //Create PDF graphics for the page. - PdfGraphics graphics = page.Graphics; - - //Set the standard font. - PdfFont font = new PdfStandardFont(PdfFontFamily.Helvetica, 8); - //Draw the text. - graphics.DrawString(ex.Message.ToString(), font, PdfBrushes.Black, new Syncfusion.Drawing.PointF(0, 0)); - - stream = new MemoryStream(); - //Save the document into memory stream. - document.Save(stream); + _logger.LogError(ex.Message.ToString(), "An error occurred while converting HTML to PDF."); + return new ContentResult + { + Content = $"Error: {ex.Message}", + ContentType = "text/plain", + StatusCode = StatusCodes.Status500InternalServerError + }; + } - document.Close(); - stream.Position = 0; - return new FileStreamResult(stream, "application/pdf"); } {% endhighlight %} -Step 7: Add the following helper methods to copy and set permission to the BlinkBinariesLinux folder. +step 7: Use the following code example in the HtmlToPdfConvert method to convert HTML to a PDF document using the [Convert](https://help.syncfusion.com/cr/document-processing/Syncfusion.HtmlConverter.HtmlToPdfConverter.html#Syncfusion_HtmlConverter_HtmlToPdfConverter_Convert_System_String_) method in the [HtmlToPdfConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.HtmlConverter.HtmlToPdfConverter.html) class. The Blink command line arguments are configured based on the given [CommandLineArguments](https://help.syncfusion.com/cr/document-processing/Syncfusion.HtmlConverter.BlinkConverterSettings.html#Syncfusion_HtmlConverter_BlinkConverterSettings_CommandLineArguments) property of the [BlinkConverterSettings](https://help.syncfusion.com/cr/document-processing/Syncfusion.HtmlConverter.BlinkConverterSettings.html) class. {% highlight c# tabtitle="C#" %} - private static string SetupBlinkBinaries( ) +public byte[] HtmlToPdfConvert(string htmlText) +{ + if (string.IsNullOrWhiteSpace(htmlText)) + { + throw new ArgumentException("HTML text cannot be null or empty.", nameof(htmlText)); + } + try { - var fileInfo = new FileInfo(Assembly.GetExecutingAssembly().Location); - string path = fileInfo.Directory.Parent.FullName; - string blinkAppDir = Path.Combine(path, @"wwwroot"); - string tempBlinkDir = Path.GetTempPath(); - string chromePath = Path.Combine(tempBlinkDir, "chrome"); - if (!File.Exists(chromePath)) + // Setup Blink binaries and install necessary packages + var blinkBinariesPath = SetupBlinkBinaries(); + InstallLinuxPackages(); + + // Initialize HTML to PDF converter + HtmlToPdfConverter htmlConverter = new HtmlToPdfConverter(HtmlRenderingEngine.Blink); + + // Display settings + BlinkConverterSettings settings = new BlinkConverterSettings + { + BlinkPath = blinkBinariesPath, + ViewPortSize = new Syncfusion.Drawing.Size(1024, 768), // Set your desired viewport size + Margin = new PdfMargins + { + Top = 20, // Set your desired margins + Left = 20, + Right = 20, + Bottom = 20 + } + }; + htmlConverter.ConverterSettings = settings; + + // Convert HTML to PDF + using (var memoryStream = new MemoryStream()) { - CopyFilesRecursively(blinkAppDir, tempBlinkDir); - SetExecutablePermission(tempBlinkDir); + PdfDocument document = htmlConverter.Convert(htmlText, null); + document.Save(memoryStream); + document.Close(true); + return memoryStream.ToArray(); } - return tempBlinkDir; } - private static void CopyFilesRecursively(string sourcePath, string targetPath) + catch (Exception ex) { - //Create all the directories from the source to the destination path. - foreach (string dirPath in Directory.GetDirectories(sourcePath, "*", SearchOption.AllDirectories)) + // Handle exceptions + Console.WriteLine("An error occurred: " + ex.Message); + throw; + } +} + +{% endhighlight %} + +N> Starting from **version 29.2.4**, it is no longer necessary to manually add the following command-line arguments when using the Blink rendering engine: +N> ```csharp +N> settings.CommandLineArguments.Add("--no-sandbox"); +N> settings.CommandLineArguments.Add("--disable-setuid-sandbox"); +N> ``` +N> These arguments are only required when using **older versions** of the library that depend on Blink in sandbox-restricted environments. + +Step 8: This code is designed to ensure that the necessary Linux packages for HTML to PDF conversion are installed if the operating system is Linux. It adjusts file permissions and executes a shell script to carry out the installation. + +{% highlight c# tabtitle="C#" %} + +// This method checks if the current operating system is Linux and installs necessary package +// dependencies for HTML to PDF conversion if they are not already installed. +private static void InstallLinuxPackages() +{ + // Check if the OS is Linux; return immediately if not. + if (!RuntimeInformation.IsOSPlatform(OSPlatform.Linux)) + { + return; + } + + // Define file permissions needed for the executable files. + FileAccessPermissions ExecutableFilePermissions = + FileAccessPermissions.UserRead | FileAccessPermissions.UserWrite | FileAccessPermissions.UserExecute | + FileAccessPermissions.GroupRead | FileAccessPermissions.GroupExecute | FileAccessPermissions.OtherRead | + FileAccessPermissions.OtherExecute; + + // Get the directory where the assembly is located. + string assemblyDirectory = Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location); + + // Path for the shell script file that installs dependencies. + string shellFilePath = Path.Combine(assemblyDirectory); + string tempBlinkDir = Path.GetTempPath(); + string dependenciesPath = Path.Combine(tempBlinkDir, "dependenciesInstall.sh"); + + // Check if the dependencies script does not already exist. + if (!File.Exists(dependenciesPath)) + { + // Copy necessary files to a temporary directory. + CopyFilesRecursively(shellFilePath, tempBlinkDir); + + // Get the path for the executable script. + var execPath = Path.Combine(tempBlinkDir, "dependenciesInstall.sh"); + + // If the script exists, update its permissions to make it executable. + if (File.Exists(execPath)) { - Directory.CreateDirectory(dirPath.Replace(sourcePath, targetPath)); + var code = Chmod(execPath, ExecutableFilePermissions); + if (code != 0) + { + throw new Exception("Chmod operation failed"); + } } - //Copy all the files from the source path to the destination path. - foreach (string newPath in Directory.GetFiles(sourcePath, "*.*", SearchOption.AllDirectories)) + + // Start a new process to run the shell script. + Process process = new Process { - File.Copy(newPath, newPath.Replace(sourcePath, targetPath), true); - } + StartInfo = new ProcessStartInfo + { + FileName = "/bin/bash", + Arguments = "-c " + execPath, + CreateNoWindow = true, + UseShellExecute = false, + } + }; + + // Execute the process and wait for it to finish. + process.Start(); + process.WaitForExit(); + } +} + +{% endhighlight %} + + +Step 9: Add the following helper methods to copy and set permission to the BlinkBinariesLinux folder. + +{% highlight c# tabtitle="C#" %} + +private static string SetupBlinkBinaries() +{ + string assemblyDirectory = Path.Combine(Path.GetDirectoryName(System.Reflection.Assembly.GetExecutingAssembly().Location), "runtimes", "linux", "native"); + string blinkAppDir = Path.Combine(assemblyDirectory); + string tempBlinkDir = Path.GetTempPath(); + string chromePath = Path.Combine(tempBlinkDir, "chrome"); + + if (!File.Exists(chromePath)) + { + CopyFilesRecursively(blinkAppDir, tempBlinkDir); + SetExecutablePermission(tempBlinkDir); + } + return tempBlinkDir; +} + +private static void CopyFilesRecursively(string sourcePath, string targetPath) +{ + // Create all the directories from the source to the destination path. + foreach (string dirPath in Directory.GetDirectories(sourcePath, "*", SearchOption.AllDirectories)) + { + Directory.CreateDirectory(dirPath.Replace(sourcePath, targetPath)); } - [DllImport("libc", SetLastError = true, EntryPoint = "chmod")] - internal static extern int Chmod(string path, FileAccessPermissions mode); - private static void SetExecutablePermission(string tempBlinkDir) + + // Copy all the files from the source path to the destination path. + foreach (string newPath in Directory.GetFiles(sourcePath, "*.*", SearchOption.AllDirectories)) + { + File.Copy(newPath, newPath.Replace(sourcePath, targetPath), true); + } +} + +[DllImport("libc", SetLastError = true, EntryPoint = "chmod")] +internal static extern int Chmod(string path, FileAccessPermissions mode); + +private static void SetExecutablePermission(string tempBlinkDir) +{ + FileAccessPermissions ExecutableFilePermissions = + FileAccessPermissions.UserRead | FileAccessPermissions.UserWrite | FileAccessPermissions.UserExecute | + FileAccessPermissions.GroupRead | FileAccessPermissions.GroupExecute | FileAccessPermissions.OtherRead | + FileAccessPermissions.OtherExecute; + + string[] executableFiles = new string[] { "chrome", "chrome_sandbox" }; + + foreach (string executable in executableFiles) { - FileAccessPermissions ExecutableFilePermissions = FileAccessPermissions.UserRead | FileAccessPermissions.UserWrite | FileAccessPermissions.UserExecute | - FileAccessPermissions.GroupRead | FileAccessPermissions.GroupExecute | FileAccessPermissions.OtherRead | FileAccessPermissions.OtherExecute; - string[] executableFiles = new string[] { "chrome", "chrome_sandbox" }; - foreach (string executable in executableFiles) + var execPath = Path.Combine(tempBlinkDir, executable); + if (File.Exists(execPath)) { - var execPath = Path.Combine(tempBlinkDir, executable); - if (File.Exists(execPath)) + var code = Chmod(execPath, ExecutableFilePermissions); + if (code != 0) { - var code = Function1.Chmod(execPath, ExecutableFilePermissions); - if (code != 0) - { - throw new Exception("Chmod operation failed"); - } + throw new Exception("Chmod operation failed"); } } } +} {% endhighlight %} -Step 8: Include the below enum in the Function1.cs file. +Step 10: Include the below enum in the Function1.cs file. {% highlight c# tabtitle="C#" %} diff --git a/Document-Processing/PDF/Conversions/HTML-To-PDF/NET/Converting-HTML-to-PDF.md b/Document-Processing/PDF/Conversions/HTML-To-PDF/NET/Converting-HTML-to-PDF.md index 6879f5075..bb47d6e8e 100644 --- a/Document-Processing/PDF/Conversions/HTML-To-PDF/NET/Converting-HTML-to-PDF.md +++ b/Document-Processing/PDF/Conversions/HTML-To-PDF/NET/Converting-HTML-to-PDF.md @@ -1,6 +1,6 @@ --- -title: Converting HTML to PDF | Syncfusion -description: Learn how to convert HTML to PDF using 3 different rendering engines (Blink, WebKit and IE) with various features like TOC, partial web page to PDF etc. +title: HTML to PDF conversion in .NET PDF Library | Syncfusion +description: Discover how to convert HTML to PDF using the Blink rendering engine, with various features like TOC, partial web page to PDF, and more. platform: document-processing control: PDF documentation: UG @@ -54,7 +54,7 @@ N> The HTML to PDF converter library internally uses the Blink rendering engine| Exception + | +Failed to convert webpage exception in Azure App Service (Windows) using CEF rendering engine — deployed via Azure DevOps pipeline + | + +
|---|---|
| Reason + | +Missing CEF (Chromium Embedded Framework) binaries during Azure pipeline deployment. + | +
| Solution + | +Add the following package references to your `.csproj` file to ensure CEF binaries are included during Azure DevOps build:
+ +{% tabs %} +{% highlight C# tabtitle="C#" %} + + |
+
| Platform(s) | +NuGet Package | +
|---|---|
| + ASP.NET Core (Targeting NET Core) + Console Application (Targeting .NET Core) + Blazor + | ++ {{'[Syncfusion.Pdf.Imaging.Net.Core.nupkg](https://www.nuget.org/packages/Syncfusion.Pdf.Imaging.Net.Core)'| markdownify }} + | +
| + Xamarin + | ++ {{'[Syncfusion.Xamarin.Pdf.Imaging.nupkg](https://www.nuget.org/packages/Syncfusion.Xamarin.Pdf.Imaging)'| markdownify }} + | +
| + Windows UI (WinUI) + .NET Multi-platform App UI (.NET MAUI) + | ++ {{'[Syncfusion.Pdf.Imaging.NET.nupkg](https://www.nuget.org/packages/Syncfusion.Pdf.Imaging.NET)'| markdownify }} + | +
| Required Native assets NuGet packages | +Applicable Linux environments | +
|---|---|
| + {{'[SkiaSharp.NativeAssets.Linux v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)'| markdownify }} + | ++ Common Linux distributions such as Ubuntu, Alpine, CentOS, Debian, Fedora, and RHEL + Azure App Service + Google App Engine + + | +
| + {{'[SkiaSharp.NativeAssets.Linux.NoDependencies v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/3.116.1)'| markdownify }} + | ++ AWS Lambda + AWS Elastic Beanstalk + | +
| Exception + | +when signing a PDF with LTA using a custom timestamp server. +System.OverflowException: `Arithmetic operation resulted in an overflow`. + | + +
|---|---|
| Reason + | +This exception occurs when the `EstimatedSignatureSize` is set too small to accommodate the data returned by certain timestamp servers. Some servers may return a larger timestamp token or include additional certificate/OCSP information, which exceeds the allocated space, causing an arithmetic overflow. + | +
| Solution + | +Increase the EstimatedSignatureSize property when configuring the PDF digital signature to ensure enough space is reserved for the full timestamp and LTV content.
+ +{% tabs %} +{% highlight C# tabtitle="C#" %} + +// Set the estimated signature size +signature.EstimatedSignatureSize = 20000; + +{% endhighlight %} +{% endtabs %} + |
+
+
+
+ }
+ Html.EndForm();
+}
+
+{% endhighlight %}
+
+
+
+Step 8: A default controller with the name *HomeController.cs* gets added to the creation of the ASP.NET Core project. Include the following namespaces in that HomeController.cs file.
+
+{% highlight c# tabtitle="C#" %}
+
+using Syncfusion.OCRProcessor;
+using Syncfusion.Pdf.Parsing;
+
+{% endhighlight %}
+
+Step 9: Add a new action method PerformOCR in the *HomeController.cs*, and include the code sample to perform OCR on the entire PDF document using [PerformOCR](https://help.syncfusion.com/cr/document-processing/Syncfusion.OCRProcessor.OCRProcessor.html#Syncfusion_OCRProcessor_OCRProcessor_PerformOCR_Syncfusion_Pdf_Parsing_PdfLoadedDocument_System_String_) method of the [OCRProcessor](https://help.syncfusion.com/cr/document-processing/Syncfusion.OCRProcessor.OCRProcessor.html) class.
+
+{% highlight c# tabtitle="C#" %}
+
+public ActionResult PerformOCR()
+{
+ string docPath = _hostingEnvironment.WebRootPath + "/Data/Input.pdf";
+ //Initialize the OCR processor.
+ using (OCRProcessor processor = new OCRProcessor())
+ {
+ FileStream fileStream = new FileStream(docPath, FileMode.Open, FileAccess.Read);
+ //Load a PDF document
+ PdfLoadedDocument lDoc = new PdfLoadedDocument(fileStream);
+ //Set OCR language to process
+ processor.Settings.Language = Languages.English;
+ //Process OCR by providing the PDF document.
+ processor.PerformOCR(lDoc);
+ //Create memory stream
+ MemoryStream stream = new MemoryStream();
+ //Save the document to memory stream
+ lDoc.Save(stream);
+ lDoc.Close();
+ //Set the position as '0'
+ stream.Position = 0;
+ //Download the PDF document in the browser
+ FileStreamResult fileStreamResult = new FileStreamResult(stream, "application/pdf");
+ fileStreamResult.FileDownloadName = "Sample.pdf";
+ return fileStreamResult;
+ }
+}
+
+{% endhighlight %}
+
+## Deploying an Application to Kubernetes
+
+### Overview
+This guide provides step-by-step instructions to deploy an application using Docker and Kubernetes. We'll tag a Docker image, push it to a repository, and apply Kubernetes configurations.
+
+### Prerequisites
+* Docker installed on your system
+* Access to a Kubernetes cluster
+* Kubernetes CLI (kubectl) installed
+
+### Detailed Explanation of Docker Image Tagging
+Step 1: Tag the Docker image
+
+Tagging a Docker image is an essential step in Docker container management. It allows you to create an alias for a Docker image, making it easier to identify and manage. Tags are often used to denote different versions or environments (e.g., development, staging, production).
+
+1.Open your terminal. Ensure Docker is running on your system.
+
+2.Run the tag command. Use the following syntax to tag your Docker image:
+
+{% highlight c# tabtitle="C#" %}
+
+ docker tag -
@@ -285,7 +285,7 @@ using Syncfusion.Pdf.Parsing;
{% endhighlight %}
-Step 5: Use the following code sample to perform OCR on the entire PDF document using [PerformOCR](https://help.syncfusion.com/cr/document-processing/Syncfusion.OCRProcessor.OCRProcessor.html#Syncfusion_OCRProcessor_OCRProcessor_PerformOCR_Syncfusion_Pdf_Parsing_PdfLoadedDocument_System_String_) method of the [OCRProcessor](https://help.syncfusion.com/cr/document-processing/Syncfusion.OCRProcessor.OCRProcessor.html) class in Program.cs file.
+Step 5: Use the following code sample to perform OCR on the entire PDF document using PerformOCR method of the [OCRProcessor](https://help.syncfusion.com/cr/document-processing/Syncfusion.OCRProcessor.OCRProcessor.html) class in Program.cs file.
{% highlight c# tabtitle="C#" %}
diff --git a/Document-Processing/PDF/PDF-Library/NET/Working-with-OCR/net-core.md b/Document-Processing/PDF/PDF-Library/NET/Working-with-OCR/net-core.md
index fa63acc21..9f41783ba 100644
--- a/Document-Processing/PDF/PDF-Library/NET/Working-with-OCR/net-core.md
+++ b/Document-Processing/PDF/PDF-Library/NET/Working-with-OCR/net-core.md
@@ -30,7 +30,7 @@ Step 2: In configuration windows, name your project and click Next.
-Step 3: Install the [Syncfusion.PDF.OCR.NET](https://www.nuget.org/packages/Syncfusion.PDF.OCR.NET) NuGet package as a reference to your .NET Standard applications from [NuGet.org](https://www.nuget.org/).
+Step 3: Install the [Syncfusion.PDF.OCR.Net.Core](https://www.nuget.org/packages/Syncfusion.PDF.OCR.Net.Core) NuGet package as a reference to your .NET Standard applications from [NuGet.org](https://www.nuget.org/).
N> 1. Beginning from version 21.1.x, the default configuration includes the addition of the TesseractBinaries and Tesseract language data folder paths, eliminating the requirement to explicitly provide these paths.
diff --git a/Document-Processing/PDF/PDF-Library/NET/Working-with-PDF-Conformance.md b/Document-Processing/PDF/PDF-Library/NET/Working-with-PDF-Conformance.md
index 044e50d71..07b65a2f7 100644
--- a/Document-Processing/PDF/PDF-Library/NET/Working-with-PDF-Conformance.md
+++ b/Document-Processing/PDF/PDF-Library/NET/Working-with-PDF-Conformance.md
@@ -1202,7 +1202,8 @@ You can download a complete working sample from [GitHub](https://github.com/Sync
An existing PDF document can be converted to PDF/A conformance document, by setting the [Conformance](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Parsing.PdfLoadedDocument.html#Syncfusion_Pdf_Parsing_PdfLoadedDocument_Conformance) value in the [PdfLoadedDocument](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Parsing.PdfLoadedDocument.html) to ```Pdf_A1B```,```Pdf_A2B```,```Pdf_A3B```, and ```Pdf_A4``` of [PdfConformanceLevel](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.PdfConformanceLevel.html). Refer to the following code sample to achieve the same.
-N> To convert the existing PDF to PDF/A conformance document in .NET Core, you need to include the Syncfusion.Pdf.Imaging.Portable assembly reference in the .NET Core project.
+N> 1.To convert the existing PDF to PDF/A conformance document in .NET Core, you need to add the [Syncfusion.Pdf.Imaging.Net.Core](https://www.nuget.org/packages/Syncfusion.Pdf.Imaging.Net.Core) package from [NuGet.org](https://www.nuget.org/) as a reference in your project.
+N> 2.For Linux environments, refer to the [documentation](https://help.syncfusion.com/document-processing/pdf/pdf-library/net/nuget-packages-required) for detailed information on the additional NuGet packages required.
{% tabs %}
@@ -1318,6 +1319,143 @@ N> 1. Converting PDF to PDF/X-1a conformance document is not supported.
N> 2. CMYK color space images and symbolic fonts are not supported.
N> 3. From the .NET Framework 3.5 version, the Essential® PDF is compatible with the PDF to PDF/A conversion.
+## Font subsetting during PDF to PDF/A conversion
+
+You can optimize the size of PDF/A documents by embedding only the required font glyphs during conversion. This is achieved by setting the SubsetFonts and [ConformanceLevel](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Parsing.PdfConformanceOptions.html#Syncfusion_Pdf_Parsing_PdfConformanceOptions_ConformanceLevel) properties using the [PdfConformanceOptions](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Parsing.PdfConformanceOptions.html) class.
+
+Refer to the following code sample for implementation.
+
+N> To convert an existing PDF to a PDF/A-compliant document in .NET Core, ensure that the **Syncfusion.Pdf.Imaging.Net.Core** assembly package is referenced in your project.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/PDF-Examples/master/PDF%20Conformance/Font_Subsetting_in_PDFA_conversion/.NET/Font_Subsetting_in_PDFA_conversion/Program.cs" %}
+
+//Load an existing PDF document
+FileStream docStream = new FileStream(@"Input.pdf", FileMode.Open, FileAccess.Read);
+PdfLoadedDocument loadedDocument = new PdfLoadedDocument(docStream);
+
+//Sample level font event handling
+loadedDocument.SubstituteFont += LoadedDocument_SubstituteFont;
+
+//Create conformance options
+PdfConformanceOptions options = new PdfConformanceOptions();
+//Set the conformance level
+options.ConformanceLevel = PdfConformanceLevel.Pdf_A1B;
+
+//Embed fonts as subsets
+options.SubsetFonts = true;
+
+// Convert to PDF/A conformance
+loadedDocument.ConvertToPDFA(options);
+
+//Save the document into stream
+MemoryStream stream = new MemoryStream();
+loadedDocument.Save(stream);
+stream.Position = 0;
+//Closes the document
+loadedDocument.Close(true);
+
+{% endhighlight %}
+
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+
+//Load an existing PDF document
+PdfLoadedDocument loadedDocument = new PdfLoadedDocument("Input.pdf");
+
+//Convert to PDF/A conformance
+PdfConformanceOptions options = new PdfConformanceOptions();
+options.ConformanceLevel = PdfConformanceLevel.Pdf_A1B;
+
+//Embed fonts as subsets
+options.SubsetFonts = true;
+loadedDocument.ConvertToPDFA(options);
+
+//Save the PDF document
+loadedDocument.Save("Output.pdf");
+//Closes the document
+loadedDocument.Close(true);
+
+{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+
+' Load an existing PDF document.
+Dim document As New PdfLoadedDocument("Input.pdf")
+
+' Convert to PDF/A conformance
+ Dim options As PdfConformanceOptions = New PdfConformanceOptions()
+ options.ConformanceLevel = PdfConformanceLevel.Pdf_A1B
+
+' Embed fonts as subsets
+ options.SubsetFonts = True
+ document.ConvertToPDFA(options)
+
+' Save the PDF document
+document.Save("Output.pdf")
+' Closes the document
+document.Close(True)
+
+{% endhighlight %}
+
+{% endtabs %}
+
+You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/PDF%20Conformance/Font_Subsetting_in_PDFA_conversion/.NET).
+
+To convert an existing PDF document to the PDFA document in .NET Core, you need to substitute the non-embedded fonts in the input document. Refer to the following code sample to achieve the same.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C# [Cross-platform]" %}
+
+static void LoadedDocument_SubstituteFont(object sender, PdfFontEventArgs args)
+
+{
+ //get the font name
+ string fontName = args.FontName.Split(',')[0];
+
+ //get the font style
+ PdfFontStyle fontStyle = args.FontStyle;
+ SKFontStyle sKFontStyle = SKFontStyle.Normal;
+
+ if (fontStyle != PdfFontStyle.Regular)
+ {
+ if (fontStyle == PdfFontStyle.Bold)
+ {
+ sKFontStyle = SKFontStyle.Bold;
+ }
+ else if (fontStyle == PdfFontStyle.Italic)
+ {
+ sKFontStyle = SKFontStyle.Italic;
+ }
+ else if (fontStyle == (PdfFontStyle.Italic | PdfFontStyle.Bold))
+ {
+ sKFontStyle = SKFontStyle.BoldItalic;
+ }
+ }
+
+ SKTypeface typeface = SKTypeface.FromFamilyName(fontName, sKFontStyle);
+ SKStreamAsset typeFaceStream = typeface.OpenStream();
+ MemoryStream memoryStream = null;
+ if (typeFaceStream != null && typeFaceStream.Length > 0)
+ {
+ //Create the fontData from the type face stream.
+ byte[] fontData = new byte[typeFaceStream.Length];
+ typeFaceStream.Read(fontData, typeFaceStream.Length);
+ typeFaceStream.Dispose();
+
+ //Create the new memory stream from the font data.
+ memoryStream = new MemoryStream(fontData);
+ }
+
+ //set the font stream to the event args.
+ args.FontStream = memoryStream;
+}
+
+{% endhighlight %}
+
+{% endtabs %}
+
## Get PDF Conformance Level
You can find the conformance level of the existing PDF document using the [Conformance](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Parsing.PdfLoadedDocument.html#Syncfusion_Pdf_Parsing_PdfLoadedDocument_Conformance) property in the [PdfLoadedDocument](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Parsing.PdfLoadedDocument.html) class. Refer to the following code sample to get the conformance level of the existing PDF document.
@@ -1517,4 +1655,4 @@ document.Close(True)
{% endtabs %}
-You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/PDF%20Conformance/Convert-PDFA-to-PDF-document).
+You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/PDF%20Conformance/Convert-PDFA-to-PDF-document).
\ No newline at end of file
diff --git a/Document-Processing/PDF/PDF-Library/NET/Working-with-Redaction.md b/Document-Processing/PDF/PDF-Library/NET/Working-with-Redaction.md
index 38681d80b..616c54d60 100644
--- a/Document-Processing/PDF/PDF-Library/NET/Working-with-Redaction.md
+++ b/Document-Processing/PDF/PDF-Library/NET/Working-with-Redaction.md
@@ -11,7 +11,7 @@ Redacting a PDF is the process of permanently removing sensitive or confidential
N> 1.CJK text without TrueType font and complex script text cannot be redacted.
N> 2.To redact the content from the existing PDF document in .NET Core, you need to add the [Syncfusion.Pdf.Imaging.Net.Core](https://www.nuget.org/packages/Syncfusion.Pdf.Imaging.Net.Core) package from [NuGet.org](https://www.nuget.org/) as a reference in your project.
-N> 3.To ensure compatibility on **Linux** when performing image-based operations such as redaction using `Syncfusion.Pdf.Imaging.Net.Core`, you must include the `SkiaSharp` library along with the `SkiaSharp.NativeAssets.Linux` package in your project.
+N> 3.For other Linux environments, refer to the [documentation](https://help.syncfusion.com/document-processing/pdf/pdf-library/net/nuget-packages-required) for detailed information on the additional NuGet packages required.
To quickly get started with redacting PDF documents in .NET using the PDF Library, check this video.
{% youtube "https://www.youtube.com/watch?v=sSnHbKm3WTk" %}
@@ -551,6 +551,141 @@ document.Close(True)
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Redaction/Redaction-without-fill-color-and-appearance/).
+## Redaction appearance fill color
+
+The Essential® PDF library allows you to enhance redaction annotations by applying a fill color using the [AppearanceFillColor](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Interactive.PdfRedactionAnnotation.html#Syncfusion_Pdf_Interactive_PdfRedactionAnnotation_AppearanceFillColor) property. This helps improve the visibility of redacted content and supports custom styling preferences.
+
+The following code example demonstrates how to apply a appearance fill color to a redaction annotation.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/PDF-Examples/master/Redaction/Redaction-fill-color-customization/.NET/Redaction-fill-color-customization/Program.cs" %}
+
+//Create a new PDF document.
+PdfDocument document = new PdfDocument();
+//Add a page to the document.
+PdfPage page = document.Pages.Add();
+
+//Create a new Redaction annotation
+PdfRedactionAnnotation annot = new PdfRedactionAnnotation();
+//Assign the Bounds Value
+annot.Bounds = new Rectangle(100, 120, 100, 100);
+//Assign the InnerColor
+annot.InnerColor = Color.Black;
+//Assign the BorderColor
+annot.BorderColor = Color.Yellow;
+
+//Assign the AppearanceFillColor
+annot.AppearanceFillColor = Color.BlueViolet;
+
+//Assign tbe TextColor
+annot.TextColor = Color.Blue;
+//Assign the font
+annot.Font = new PdfStandardFont(PdfFontFamily.Helvetica, 10);
+//Assign the OverlayText
+annot.OverlayText = "REDACTION";
+//Assign the TextAlignment
+annot.TextAlignment = PdfTextAlignment.Right;
+//Assign the RepeatText
+annot.RepeatText = true;
+annot.SetAppearance(true);
+
+//Add the annotation to the page
+page.Annotations.Add(annot);
+
+//Save the document into stream.
+MemoryStream stream = new MemoryStream();
+document.Save(stream);
+//Close the document.
+document.Close(true);
+
+{% endhighlight %}
+
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+
+//Create a new PDF document.
+PdfDocument document = new PdfDocument();
+//Add a page to the document.
+PdfPage page = document.Pages.Add();
+
+//Create a new Redaction annotation
+PdfRedactionAnnotation annot = new PdfRedactionAnnotation();
+//Assign the Bounds Value
+annot.Bounds = new Rectangle(100, 120, 100, 100);
+//Assign the InnerColor
+annot.InnerColor = Color.Black;
+//Assign the BorderColor
+annot.BorderColor = Color.Yellow;
+
+//Assign the AppearanceFillColor
+annot.AppearanceFillColor = Color.BlueViolet;
+
+//Assign tbe TextColor
+annot.TextColor = Color.Blue;
+//Assign the font
+annot.Font = new PdfStandardFont(PdfFontFamily.Helvetica, 10);
+//Assign the OverlayText
+annot.OverlayText = "REDACTION";
+//Assign the TextAlignment
+annot.TextAlignment = PdfTextAlignment.Right;
+//Assign the RepeatText
+annot.RepeatText = true;
+annot.SetAppearance(true);
+
+//Add the annotation to the page
+page.Annotations.Add(annot);
+
+//Save the PDF document
+document.Save("Output.pdf");
+//Close the document.
+document.Close(true);
+
+{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+
+' Create a new PDF document
+Dim document As PdfDocument = New PdfDocument()
+' Create a new page
+Dim page As PdfPage = document.Pages.Add()
+
+' Create a New Redaction annotation
+Dim annot As PdfRedactionAnnotation = New PdfRedactionAnnotation()
+' Assign the Bounds value
+annot.Bounds = New Rectangle(100, 120, 100, 100)
+' Assign the InnerColor
+annot.InnerColor = Color.Black
+' Assign the BorderColor
+annot.BorderColor = Color.Yellow
+
+' Assign the AppearanceFillColor
+annot.AppearanceFillColor = Color.BlueViolet;
+
+' Assign the TextColor
+annot.TextColor = Color.Blue
+' Assign the font value
+annot.Font = New PdfStandardFont(PdfFontFamily.Helvetica, 10)
+' Assign the OverlayText
+annot.OverlayText = "REDACTION"
+' Assign the TextAlignment
+annot.TextAlignment = PdfTextAlignment.Right
+' Assign the RepeatText
+annot.RepeatText = True
+annot.SetAppearance(True)
+
+' Add the annotation to the page.
+page.Annotations.Add(annot)
+
+'Save and close the document.
+document.Save("Output.pdf")
+document.Close(True)
+
+{% endhighlight %}
+
+{% endtabs %}
+
+You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Redaction/Redaction-fill-color-customization/.NET).
+
## Get redaction progress
You can get the redaction process using [RedactionProgress](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Parsing.PdfLoadedDocument.html#Syncfusion_Pdf_Parsing_PdfLoadedDocument_RedactionProgress) event in [PdfLoadedDocument](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Parsing.PdfLoadedDocument.html) class.
diff --git a/Document-Processing/PDF/PDF-Library/NET/Working-with-Security.md b/Document-Processing/PDF/PDF-Library/NET/Working-with-Security.md
index 49b7b0aee..1ae3a0afa 100644
--- a/Document-Processing/PDF/PDF-Library/NET/Working-with-Security.md
+++ b/Document-Processing/PDF/PDF-Library/NET/Working-with-Security.md
@@ -420,6 +420,136 @@ document.Close(True)
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Security/Encrypt-PDF-with-AES-using-owner-password/).
+## Working with AES-GCM encryption
+
+To encrypt a PDF document using AES-GCM, set the [Algorithm](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Security.PdfSecurity.html#Syncfusion_Pdf_Security_PdfSecurity_Algorithm) property to AESGCM using the [PdfEncryptionAlgorithm](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Security.PdfEncryptionAlgorithm.html) enum and the KeySize property to **256bit** using the PdfEncryptionKeySize enum in the [PdfSecurity](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Security.PdfSecurity.html) class.
+
+N> AES-GCM encryption is supported only in PDF version 2.0. Ensure that the PDF file version is set to 2.0.
+
+Refer to the following code example for further details.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/PDF-Examples/master/Security/Secure_data%20_with%20_AES_GCM/.NET/Secure_data%20_with%20_AES_GCM/Program.cs" %}
+
+//Create a new PDF document.
+PdfDocument document = new PdfDocument();
+
+//Set the document version as 2.0
+document.FileStructure.Version = PdfVersion.Version2_0;
+
+//Add a page to the document.
+PdfPage page = document.Pages.Add();
+
+//Create PDF graphics for the page.
+PdfGraphics graphics = page.Graphics;
+//Create font.
+PdfStandardFont font = new PdfStandardFont(PdfFontFamily.TimesRoman, 15f, PdfFontStyle.Bold);
+//Create brush.
+PdfBrush brush = PdfBrushes.Black;
+
+//Draw the text.
+graphics.DrawString("Encrypted document with AES-GCM 256bit", font, brush, new PointF(0, 40));
+
+//Get document security.
+PdfSecurity security = document.Security;
+//Specifies key size and encryption algorithm.
+security.KeySize = PdfEncryptionKeySize.Key256Bit;
+security.Algorithm = PdfEncryptionAlgorithm.AESGCM;
+
+//Set Owner and User password.
+security.OwnerPassword = "ownerPassword";
+security.UserPassword = "userPassword";
+
+//Save the document into stream.
+MemoryStream stream = new MemoryStream();
+document.Save(stream);
+
+//Close the document.
+document.Close(true);
+
+{% endhighlight %}
+
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+
+//Create a new PDF document.
+PdfDocument document = new PdfDocument();
+
+//Set the document version as 2.0
+document.FileStructure.Version = PdfVersion.Version2_0;
+
+//Add a page to the document.
+PdfPage page = document.Pages.Add();
+
+//Create PDF graphics for the page.
+PdfGraphics graphics = page.Graphics;
+
+//Set the font.
+PdfStandardFont font = new PdfStandardFont(PdfFontFamily.TimesRoman, 15f, PdfFontStyle.Bold);
+
+//Set the brush.
+PdfBrush brush = PdfBrushes.Black;
+
+//Document security.
+PdfSecurity security = document.Security;
+
+//Specifies key size and encryption algorithm.
+security.KeySize = PdfEncryptionKeySize.Key256Bit;
+security.Algorithm = PdfEncryptionAlgorithm.AESGCM;
+security.OwnerPassword = "ownerPassword";
+security.UserPassword = "userPassword";
+
+//Draw the text.
+graphics.DrawString("Encrypted document with AES-GCM 256bit", font, brush, new PointF(0, 40));
+
+//Save and close the document.
+document.Save("Output.pdf");
+document.Close(true);
+
+{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+
+' Create a new PDF document
+Dim document As PdfDocument = New PdfDocument()
+
+' Set the document version as 2.0
+document.FileStructure.Version = PdfVersion.Version2_0
+
+' Add a page to the document
+Dim page As PdfPage = document.Pages.Add()
+
+' Create PDF graphics for the page
+Dim graphics As PdfGraphics = page.Graphics
+
+' Set the font
+Dim font As New PdfStandardFont(PdfFontFamily.TimesRoman, 20.0F, PdfFontStyle.Bold)
+
+' Set the brush
+Dim brush As PdfBrush = PdfBrushes.Black
+
+'Document security.
+Dim security As PdfSecurity = document.Security
+
+'Specifies key size and encryption algorithm using 256 bit key in AES-GCM mode.
+security.KeySize = PdfEncryptionKeySize.Key256Bit
+security.Algorithm = PdfEncryptionAlgorithm.AESGCM
+security.OwnerPassword = "ownerPassword"
+security.UserPassword = "userPassword"
+
+'Draw the text.
+graphics.DrawString("Encrypted document with AES-GCM 256bit", font, brush, New PointF(0, 40))
+
+'Save and close the document.
+document.Save("Output.pdf")
+document.Close(True)
+
+{% endhighlight %}
+
+{% endtabs %}
+
+You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Security/Secure_data%20_with%20_AES_GCM/.NET).
+
## Encryption Options
Now, the Syncfusion® PDF library has provided options to encrypt the PDF document as follows:
diff --git a/Document-Processing/PDF/PDF-Library/NET/Working-with-Tagged-PDF.md b/Document-Processing/PDF/PDF-Library/NET/Working-with-Tagged-PDF.md
index f85b9416e..c85b41ebc 100644
--- a/Document-Processing/PDF/PDF-Library/NET/Working-with-Tagged-PDF.md
+++ b/Document-Processing/PDF/PDF-Library/NET/Working-with-Tagged-PDF.md
@@ -1210,6 +1210,249 @@ document.Close(True)
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Tagged%20PDF/Add-the-tag-to-list-element-in-PDF-document).
+### Adding tags to nested list elements
+
+You can apply tags to nested list elements using the [PdfStructureElement](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.PdfStructureElement.html) class, which helps define the structural hierarchy and semantic roles of both main and sublist items. This ensures better document accessibility and logical organization. Refer to the code example below for implementation details.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C# [Cross-platform]" %}
+
+// Create a new PDF document
+PdfDocument document = new PdfDocument();
+
+// Set the document title
+document.DocumentInformation.Title = "Nested List";
+
+// Add a new page to the PDF
+PdfPage page = document.Pages.Add();
+PdfGraphics graphics = page.Graphics;
+SizeF size = page.Graphics.ClientSize;
+
+//Get stream from the font file.
+FileStream fontStream = new FileStream("Arial.ttf", FileMode.Open, FileAccess.Read);
+PdfFont font = new PdfTrueTypeFont(fontStream, 14);
+
+// Draw the title on the PDF
+graphics.DrawString("Nested Ordered List:", font, PdfBrushes.Blue, new PointF(10, 0));
+
+// Create a string format for line spacing of list items
+PdfStringFormat format = new PdfStringFormat();
+format.LineSpacing = 10f;
+
+// Create the main list structure element with a List tag for accessibility
+PdfStructureElement mainListElement = new PdfStructureElement(PdfTagType.List);
+
+// Initialize the main ordered list
+PdfOrderedList mainList = new PdfOrderedList
+{
+ PdfTag = mainListElement,
+ Marker = { Brush = PdfBrushes.Black },
+ Indent = 20,
+ Font = font,
+ StringFormat = format
+};
+
+// Add items to the main list and tag each item for accessibility
+string[] mainItems = { "Essential Tools", "Essential PDF", "Essential XlsIO" };
+for (int i = 0; i < mainItems.Length; i++)
+{
+ mainList.Items.Add(mainItems[i]);
+ mainList.Items[i].PdfTag = new PdfStructureElement(PdfTagType.ListItem);
+}
+
+// Create a sublist with accessibility tags
+PdfStructureElement subListElement = new PdfStructureElement(PdfTagType.List);
+PdfOrderedList subList = new PdfOrderedList
+{
+ PdfTag = subListElement,
+ Marker = { Brush = PdfBrushes.Black },
+ Indent = 20,
+ Font = font,
+ StringFormat = format
+};
+
+// Add items to the sublist and tag each item for accessibility
+string[] subItems = { "Create PDF", "Modify PDF", "Secure PDF", "Compress PDF" };
+for (int i = 0; i < subItems.Length; i++)
+{
+ subList.Items.Add(subItems[i]);
+ subList.Items[i].PdfTag = new PdfStructureElement(PdfTagType.ListItem);
+}
+// Nest the sublist under the second item of the main list
+mainList.Items[1].SubList = subList;
+
+// Draw the main list, which includes the nested sublist, on the PDF
+mainList.Draw(page, new RectangleF(0, 30, size.Width, size.Height));
+
+//Create file stream.
+using (FileStream outputFileStream = new FileStream("Output.pdf", FileMode.Create, FileAccess.ReadWrite))
+{
+ //Save the PDF document to file stream.
+ document.Save(outputFileStream);
+}
+//Close the document.
+document.Close(true);
+
+{% endhighlight %}
+
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+
+// Create a new PDF document
+PdfDocument document = new PdfDocument();
+
+// Set the document title
+document.DocumentInformation.Title = "Nested List";
+
+// Add a new page to the PDF
+PdfPage page = document.Pages.Add();
+PdfGraphics graphics = page.Graphics;
+SizeF size = page.Graphics.ClientSize;
+
+//Get stream from the font file.
+FileStream fontStream = new FileStream("Arial.ttf", FileMode.Open, FileAccess.Read);
+PdfFont font = new PdfTrueTypeFont(fontStream, 14);
+
+// Draw the title on the PDF
+graphics.DrawString("Nested Ordered List:", font, PdfBrushes.Blue, new PointF(10, 0));
+
+// Create a string format for line spacing of list items
+PdfStringFormat format = new PdfStringFormat();
+format.LineSpacing = 10f;
+
+// Create the main list structure element with a List tag for accessibility
+PdfStructureElement mainListElement = new PdfStructureElement(PdfTagType.List);
+
+// Initialize the main ordered list
+PdfOrderedList mainList = new PdfOrderedList
+{
+ PdfTag = mainListElement,
+ Marker = { Brush = PdfBrushes.Black },
+ Indent = 20,
+ Font = font,
+ StringFormat = format
+};
+
+// Add items to the main list and tag each item for accessibility
+string[] mainItems = { "Essential Tools", "Essential PDF", "Essential XlsIO" };
+for (int i = 0; i < mainItems.Length; i++)
+{
+ mainList.Items.Add(mainItems[i]);
+ mainList.Items[i].PdfTag = new PdfStructureElement(PdfTagType.ListItem);
+}
+
+// Create a sublist with accessibility tags
+PdfStructureElement subListElement = new PdfStructureElement(PdfTagType.List);
+PdfOrderedList subList = new PdfOrderedList
+{
+ PdfTag = subListElement,
+ Marker = { Brush = PdfBrushes.Black },
+ Indent = 20,
+ Font = font,
+ StringFormat = format
+};
+
+// Add items to the sublist and tag each item for accessibility
+string[] subItems = { "Create PDF", "Modify PDF", "Secure PDF", "Compress PDF" };
+for (int i = 0; i < subItems.Length; i++)
+{
+ subList.Items.Add(subItems[i]);
+ subList.Items[i].PdfTag = new PdfStructureElement(PdfTagType.ListItem);
+}
+// Nest the sublist under the second item of the main list
+mainList.Items[1].SubList = subList;
+
+// Draw the main list, which includes the nested sublist, on the PDF
+mainList.Draw(page, new RectangleF(0, 30, size.Width, size.Height));
+
+//Save the PDF document
+document.Save("Output.pdf");
+//Close the document.
+document.Close(true);
+
+{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+
+' Create a new PDF document
+Dim document As New PdfDocument()
+
+' Set the document title
+document.DocumentInformation.Title = "Nested List"
+
+' Add a new page to the PDF
+Dim page As PdfPage = document.Pages.Add()
+Dim graphics As PdfGraphics = page.Graphics
+Dim size As SizeF = graphics.ClientSize
+
+' Get stream from the font file
+Dim fontStream As New FileStream("Arial.ttf", FileMode.Open, FileAccess.Read)
+Dim font As New PdfTrueTypeFont(fontStream, 14)
+
+' Draw the title on the PDF
+graphics.DrawString("Nested Ordered List:", font, PdfBrushes.Blue, New PointF(10, 0))
+
+' Create a string format for line spacing of list items
+Dim format As New PdfStringFormat()
+format.LineSpacing = 10.0F
+
+' Create the main list structure element with a List tag for accessibility
+Dim mainListElement As New PdfStructureElement(PdfTagType.List)
+
+' Initialize the main ordered list
+Dim mainList As New PdfOrderedList() With {
+ .PdfTag = mainListElement,
+ .Marker = New PdfOrderedMarkers() With {.Brush = PdfBrushes.Black},
+ .Indent = 20,
+ .Font = font,
+ .StringFormat = format
+}
+
+' Add items to the main list and tag each item for accessibility
+Dim mainItems As String() = {"Essential Tools", "Essential PDF", "Essential XlsIO"}
+For Each item As String In mainItems
+ Dim listItem As New PdfListItem(item) With {
+ .PdfTag = New PdfStructureElement(PdfTagType.ListItem)
+ }
+ mainList.Items.Add(listItem)
+Next
+
+' Create a sublist with accessibility tags
+Dim subListElement As New PdfStructureElement(PdfTagType.List)
+Dim subList As New PdfOrderedList() With {
+ .PdfTag = subListElement,
+ .Marker = New PdfOrderedMarkers() With {.Brush = PdfBrushes.Black},
+ .Indent = 20,
+ .Font = font,
+ .StringFormat = format
+}
+
+' Add items to the sublist and tag each item for accessibility
+Dim subItems As String() = {"Create PDF", "Modify PDF", "Secure PDF", "Compress PDF"}
+For Each item As String In subItems
+ Dim listItem As New PdfListItem(item) With {
+ .PdfTag = New PdfStructureElement(PdfTagType.ListItem)
+ }
+ subList.Items.Add(listItem)
+Next
+
+' Nest the sublist under the second item of the main list
+mainList.Items(1).SubList = subList
+
+' Draw the main list, which includes the nested sublist, on the PDF
+mainList.Draw(page, New RectangleF(0, 30, size.Width, size.Height))
+
+' Save the PDF document
+document.Save("Output.pdf")
+' Close the document
+document.Close(True)
+
+{% endhighlight %}
+
+{% endtabs %}
+
+You can download a complete working sample from GitHub.
+
## Well-Tagged PDF (WTPDF)
Well-Tagged PDF (WTPDF) enables the creation of fully reusable and accessible PDF 2.0 files in an interoperable manner. WTPDF is essentially identical to PDF/UA-2. A PDF file can be compliant with PDF/UA-2, WTPDF, or both.
diff --git a/Document-Processing/PDF/PDF-Library/NET/Working-with-Text.md b/Document-Processing/PDF/PDF-Library/NET/Working-with-Text.md
index b0ec88d13..afe673202 100644
--- a/Document-Processing/PDF/PDF-Library/NET/Working-with-Text.md
+++ b/Document-Processing/PDF/PDF-Library/NET/Working-with-Text.md
@@ -7,6 +7,11 @@ documentation: UG
---
# Working with text in the PDF document
+Essential® PDF supports adding text to a PDF document using the Syncfusion .NET PDF library. You can add text using standard, TrueType, CJK fonts, RTL text, and complex scripts.
+
+To quickly get started with adding text to PDF documents using the Syncfusion® PDF library for .NET, refer to this video tutorial:
+{% youtube "https://youtu.be/-LJdP6x1JmM?si=NfMHO8l1pKeY-dV-" %}
+
## Drawing text in a new document
You can add text in the new PDF document by using [DrawString](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html#Syncfusion_Pdf_Graphics_PdfGraphics_DrawString_System_String_Syncfusion_Pdf_Graphics_PdfFont_Syncfusion_Pdf_Graphics_PdfBrush_System_Drawing_PointF_) method of [PdfGraphics][def] class as shown in the following code sample.
@@ -80,7 +85,9 @@ document.Close(True)
{% endtabs %}
-You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Text/Drawing-text-in-a-new-PDF-document/).
+You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Text/Drawing-text-in-a-new-PDF-document/).
+
+N> Due to the inherent limitations of the PDF specification and the rendering capabilities of PDF libraries, emojis with skin tone modifiers are not supported in generated PDF documents. Only the base versions of emojis can be displayed. This limitation is common across most PDF libraries, as the PDF format does not explicitly support rendering skin tone variations in emojis.
## The importance of saving and restoring graphics state in PDF content rendering
Saving and restoring the graphics state in a PDF document is crucial for maintaining the consistency and integrity of the document's layout and appearance. This approach allows you to make temporary changes to the graphics state, such as transformations, clipping paths, or color adjustments, without affecting subsequent content rendering by using the [Save](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html#Syncfusion_Pdf_Graphics_PdfGraphics_Save) and [Restore](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html#Syncfusion_Pdf_Graphics_PdfGraphics_Restore) methods of the [PdfGraphics][https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Graphics.PdfGraphics.html] class.
diff --git a/Document-Processing/PDF/PDF-Library/NET/Working-with-forms.md b/Document-Processing/PDF/PDF-Library/NET/Working-with-forms.md
index e64a123f9..de6a7987f 100644
--- a/Document-Processing/PDF/PDF-Library/NET/Working-with-forms.md
+++ b/Document-Processing/PDF/PDF-Library/NET/Working-with-forms.md
@@ -1817,9 +1817,9 @@ loadedDocument.Close(True)
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Forms/Flatten-the-existing-form-fields-with-complex-script).
-## Auto naming of form fields
+## Grouping (auto naming) of form fields
-The Essential® PDF supports auto naming of form fields in a PDF document while creating form fields with same name. The [FieldAutoNaming](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Interactive.PdfForm.html#Syncfusion_Pdf_Interactive_PdfForm_FieldAutoNaming) property of [PdfForm](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Interactive.PdfForm.html) is used to enable or disable auto naming of form field.
+The Essential® PDF supports grouping (auto naming) of form fields in a PDF document while creating form fields with same name. The [FieldAutoNaming](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Interactive.PdfForm.html#Syncfusion_Pdf_Interactive_PdfForm_FieldAutoNaming) property of [PdfForm](https://help.syncfusion.com/cr/document-processing/Syncfusion.Pdf.Interactive.PdfForm.html) is used to enable or disable auto naming of form field.
While enabling this property, the field names are auto naming. If the fields are created using same/common name, the created fields will act as individual.
@@ -2703,6 +2703,180 @@ doc.Close(True)
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/PDF-Examples/tree/master/Forms/Get-option-value-from-acroform-radio-button).
+## Unified radio button selection
+
+The essential® PDF allows radio buttons within the same group that have identical export values to be selected or deselected simultaneously.
+
+If **AllowUnisonSelection** is disabled, radio buttons, even with the same label, operate independently and do not share selection states.
+
+With **AllowUnisonSelection** enabled, radio buttons sharing the same name within a group will function collectively, maintaining a unified selection state.
+
+The following code example illustrates how to enable or disable unison functionality for radio button fields.
+
+{% tabs %}
+
+{% highlight c# tabtitle="C# [Cross-platform]" %}
+
+//Create a new PDF document
+PdfDocument document = new PdfDocument();
+//Add a new page to the PDF document.
+PdfPage page = document.Pages.Add();
+
+//Create the form.
+PdfForm form = document.Form;
+//Set default appearance as false.
+document.Form.SetDefaultAppearance(false);
+
+// Create a radio button list
+PdfRadioButtonListField reportFrequencyRadioList = new PdfRadioButtonListField(page, "reportFrequency");
+
+//only one selection allowed
+reportFrequencyRadioList.AllowUnisonSelection = false;
+PdfRadioButtonListItem dailyItem = new PdfRadioButtonListItem(page, "Daily");
+dailyItem.Bounds = new RectangleF(100, 100, 20, 20);
+
+// Create radio button item: "Weekly"
+PdfRadioButtonListItem weeklyItem = new PdfRadioButtonListItem(page, "Weekly");
+weeklyItem.Bounds = new RectangleF(100, 140, 20, 20);
+
+// Create radio button item: "Monthly"
+PdfRadioButtonListItem monthlyItem = new PdfRadioButtonListItem(page, "Monthly");
+monthlyItem.Bounds = new RectangleF(100, 180, 20, 20);
+
+// Add items to the radio button list
+reportFrequencyRadioList.Items.Add(dailyItem);
+reportFrequencyRadioList.Items.Add(weeklyItem);
+reportFrequencyRadioList.Items.Add(monthlyItem);
+
+// Add the radio button list field to the document's form fields
+document.Form.Fields.Add(reportFrequencyRadioList);
+
+//Save the document into stream
+MemoryStream stream = new MemoryStream();
+document.Save(stream);
+stream.Position = 0;
+//Closes the document
+document.Close(true);
+
+{% endhighlight %}
+
+{% highlight c# tabtitle="C# [Windows-specific]" %}
+
+//Create a new PDF document
+PdfDocument document = new PdfDocument();
+//Add a new page to the PDF document.
+PdfPage page = document.Pages.Add();
+
+//Create the form.
+PdfForm form = document.Form;
+//Set default appearance as false.
+document.Form.SetDefaultAppearance(false);
+
+// Create a radio button list
+PdfRadioButtonListField reportFrequencyRadioList = new PdfRadioButtonListField(page, "reportFrequency");
+
+//only one selection allowed
+reportFrequencyRadioList.AllowUnisonSelection = false;
+PdfRadioButtonListItem dailyItem = new PdfRadioButtonListItem(page, "Daily");
+dailyItem.Bounds = new RectangleF(100, 100, 20, 20);
+
+// Create radio button item: "Weekly"
+PdfRadioButtonListItem weeklyItem = new PdfRadioButtonListItem(page, "Weekly");
+weeklyItem.Bounds = new RectangleF(100, 140, 20, 20);
+
+// Create radio button item: "Monthly"
+PdfRadioButtonListItem monthlyItem = new PdfRadioButtonListItem(page, "Monthly");
+monthlyItem.Bounds = new RectangleF(100, 180, 20, 20);
+
+// Add items to the radio button list
+reportFrequencyRadioList.Items.Add(dailyItem);
+reportFrequencyRadioList.Items.Add(weeklyItem);
+reportFrequencyRadioList.Items.Add(monthlyItem);
+
+// Add the radio button list field to the document's form fields
+document.Form.Fields.Add(reportFrequencyRadioList);
+
+//Save the document.
+document.Save("Output.pdf");
+//Close the document.
+document.Close(true);
+
+{% endhighlight %}
+
+{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %}
+
+' Create a new PDF document
+Dim document As New PdfDocument()
+'Add a new page to the PDF document
+Dim page As PdfPage = document.Pages.Add()
+
+'Create the form
+Dim form As PdfForm = document.Form
+
+' Set default appearance as false.
+document.Form.SetDefaultAppearance(False)
+
+' Create a radio button list
+Dim reportFrequencyRadioList As New PdfRadioButtonListField(page, "reportFrequency")
+
+' Only one selection allowed
+reportFrequencyRadioList.AllowUnisonSelection = False
+
+' Create radio button item: "Daily"
+Dim dailyItem As New PdfRadioButtonListItem(page, "Daily")
+dailyItem.Bounds = New RectangleF(100, 100, 20, 20)
+
+' Create radio button item: "Weekly"
+Dim weeklyItem As New PdfRadioButtonListItem(page, "Weekly")
+weeklyItem.Bounds = New RectangleF(100, 140, 20, 20)
+
+' Create radio button item: "Monthly"
+Dim monthlyItem As New PdfRadioButtonListItem(page, "Monthly")
+monthlyItem.Bounds = New RectangleF(100, 180, 20, 20)
+
+' Add items to the radio button list
+reportFrequencyRadioList.Items.Add(dailyItem)
+reportFrequencyRadioList.Items.Add(weeklyItem)
+reportFrequencyRadioList.Items.Add(monthlyItem)
+
+' Add the radio button list field to the document's form fields
+document.Form.Fields.Add(reportFrequencyRadioList)
+
+'Save the document
+document.Save("Output.pdf")
+'Close the document
+document.Close(True)
+
+{% endhighlight %}
+
+{% endtabs %}
+
+You can download a complete working sample from GitHub.
+
+The screenshot below highlights the difference between having the radio button unison feature disabled versus enabled.
+
+
| Disabling Unison | +Unison Enabled | +
|---|---|
|
+ + 
+ + |
+
+ + 
+ + |
+
Syncfusion.Pdf.Portable
Syncfusion.Pdf.Imaging.Portable
Syncfusion.PresentationRenderer.Portable
-Syncfusion.MetafileRenderer.NET
+Syncfusion.MetafileRenderer.Portable
Syncfusion.SkiaSharpHelper.Portable
SkiaSharp
| Required Native assets NuGet packages | +Applicable Linux environments | +
|---|---|
|
+ {{'[SkiaSharp.NativeAssets.Linux v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)'| markdownify }} + {{'[HarfBuzzSharp.NativeAssets.Linux v8.3.0.1](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.0.1)'| markdownify }} + |
+
+
|
+
| + {{'[SkiaSharp.NativeAssets.Linux.NoDependencies v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/3.116.1)'| markdownify }} + | +
+
|
+
Syncfusion.Pdf.Portable
Syncfusion.PresentationRenderer.Portable
Syncfusion.Pdf.Imaging.Portable
-Syncfusion.MetafileRenderer.NET
+Syncfusion.MetafileRenderer.Portable
Syncfusion.SkiaSharpHelper.Portable
SkiaSharp @@ -59,9 +59,10 @@ Syncfusion.OfficeChart.NET
Syncfusion.PresentationRenderer.NET
Syncfusio -T> Switch to NuGet packages for a seamless experience: -T> * Get frequent bug fixes every week. -T> * Upgrade quickly with no manual effort. +T> 1. If you encounter issues while using the .NET PowerPoint library in ASP.NET Core, refer to the [troubleshooting guide](https://support.syncfusion.com/kb/article/16010/how-to-use-troubleshooting-guide-for-aspnet-core-powerpoint-library-issues) for recommended checks and solutions. +T> 2. Switch to NuGet packages for a seamless experience: +T> * Get frequent bug fixes every week. +T> * Upgrade quickly with no manual effort. T> Note: To avoid trail watermark when using NuGet packages, it is recommended to register license key in application. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. T> T> Refer [here](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion) to know more about NuGet packages required. diff --git a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-ASP-NET-Core.md b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-ASP-NET-Core.md index 7f5479b1c..377282833 100644 --- a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-ASP-NET-Core.md +++ b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-ASP-NET-Core.md @@ -28,8 +28,10 @@ Step 1: Create a new C# ASP.NET Core web application project. Step 2: Install the [Syncfusion.PresentationRenderer.Net.Core](https://www.nuget.org/packages/Syncfusion.PresentationRenderer.Net.Core) NuGet package as reference to your .NET Standard applications from [NuGet.org](https://www.nuget.org/).  - -N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. + +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. + Step 3: Include the following namespaces in **HomeController.cs**. {% tabs %} @@ -130,7 +132,9 @@ Step 2: To **convert a PowerPoint document to PDF in ASP.NET Core Web app**, ins  -N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. + Step 3: Include the following namespaces in **HomeController.cs**. {% tabs %} @@ -247,7 +251,8 @@ Step 2: Install the NuGet package from [NuGet.org](https://www.nuget.org/).  -N> Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion license key in your application to use our components. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion license key in your application to use our components. Step 3: Include the following namespaces in **HomeController.cs**. diff --git a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-ASP-Net.md b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-ASP-Net.md index 2000e4f8e..24131c0bd 100644 --- a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-ASP-Net.md +++ b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-ASP-Net.md @@ -10,7 +10,7 @@ documentation: UG Syncfusion® PowerPoint is a [.NET PowerPoint library](https://www.syncfusion.com/document-processing/powerpoint-framework/net) used to create, read, edit and **convert PowerPoint presentation** programmatically without **Microsoft PowerPoint** or interop dependencies. Using this library, you can **convert a PowerPoint to PDF in ASP.NET**. -N> This ASP.NET Web Form platform is deprecated, you can use the same product from ASP.NET Core platform. For more information on migrating the .NET Word library from .NET Framework to .NET Core, refer [here](https://help.syncfusion.com/document-processing/powerpoint/powerpoint-library/net/faqs/migrate-from-net-framework-to-net-core). +N> This ASP.NET Web Form platform is deprecated, you can use the same product from ASP.NET Core platform. For more information on migrating the .NET PowerPoint library from .NET Framework to .NET Core, refer [here](https://help.syncfusion.com/document-processing/powerpoint/powerpoint-library/net/faqs/migrate-from-net-framework-to-net-core). ## Steps to convert PowerPoint to PDF programmatically diff --git a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Blazor.md b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Blazor.md index 726a5f160..7e760634c 100644 --- a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Blazor.md +++ b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Blazor.md @@ -29,7 +29,8 @@ Step 2: Install the [Syncfusion.PresentationRenderer.Net.Core](https://www.nuget  -N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. Step 3: Create a razor file with name as **Presentation** under **Pages** folder and include the following namespaces in the file. @@ -235,7 +236,8 @@ Step 2: To **convert a PowerPoint to PDF in server app**, install [Syncfusion.Pr  -N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. Step 3: Create a razor file with name as **Presentation** under **Pages** folder and include the following namespaces in the file. @@ -458,7 +460,8 @@ Step 2: Install the NuGet package from [NuGet.org](https://www.nuget.org/).  -N> Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion license key in your application to use our components. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion license key in your application to use our components. Step 3: Create a razor file with name as **Presentation** under **Pages** folder and include the following namespaces in the file. @@ -670,8 +673,9 @@ Step 2: Install the following **Nuget packages** in your application from [Nuget  -N> 1. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. -N> 2. Install this wasm-tools and wasm-tools-net6 by using the "dotnet workload install wasm-tools" and "dotnet workload install wasm-tools-net6" commands in your command prompt respectively if you are facing issues related to Skiasharp during runtime. After installing wasm tools using the above commands, please restart your machine. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. +N> 3. Install this wasm-tools and wasm-tools-net6 by using the "dotnet workload install wasm-tools" and "dotnet workload install wasm-tools-net6" commands in your command prompt respectively if you are facing issues related to Skiasharp during runtime. After installing wasm tools using the above commands, please restart your machine. Step 3: Create a razor file with name as ``Presentation`` under ``Pages`` folder and add the following namespaces in the file. @@ -839,9 +843,9 @@ Step 2: To **convert a PowerPoint to PDF in Blazor WASM app**, install [Syncfusi  -N> 1. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. -N> 2. If you face issues related to SkiaSharp during runtime, install the necessary WebAssembly tools by running the following commands in the terminal: - +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. +N> 3. If you face issues related to SkiaSharp during runtime, install the necessary WebAssembly tools by running the following commands in the terminal: N> ``` N> dotnet workload install wasm-tools N> dotnet workload install wasm-tools-net6 @@ -1033,8 +1037,9 @@ Step 2: Install the NuGet package from [NuGet.org](https://www.nuget.org/).  -N> 1. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. -N> 2. Install this wasm-tools and wasm-tools-net6 by using the "dotnet workload install wasm-tools" and "dotnet workload install wasm-tools-net6" commands in your command prompt respectively if you are facing issues related to Skiasharp during runtime. After installing wasm tools using the above commands, please restart your machine. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. +N> 3. Install this wasm-tools and wasm-tools-net6 by using the "dotnet workload install wasm-tools" and "dotnet workload install wasm-tools-net6" commands in your command prompt respectively if you are facing issues related to Skiasharp during runtime. After installing wasm tools using the above commands, please restart your machine. Step 3: Create a razor file with name as ``Presentation`` under ``Pages`` folder and add the following namespaces in the file. diff --git a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Console-application.md b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Console-application.md index 48b6bde33..905d4ada9 100644 --- a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Console-application.md +++ b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Console-application.md @@ -28,7 +28,8 @@ Step 2: Install the [Syncfusion.PresentationRenderer.Net.Core](https://www.nuget  -N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. Step 3: Include the following namespaces in **Program.cs** file. @@ -108,7 +109,8 @@ Step 2: To **convert a PowerPoint document to PDF in console app**, install [Syn  -N> Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. Step 3: Include the following namespaces in **Program.cs** file. @@ -204,7 +206,8 @@ Step 2: Install the NuGet package from [NuGet.org](https://www.nuget.org/).  -N> Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion license key in your application to use our components. +N> 1. If you're deploying the application in a Linux environment, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for the required additional NuGet packages. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion license key in your application to use our components. Step 3: Include the following namespaces in **Program.cs** file. diff --git a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Linux.md b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Linux.md index ef1b914f0..bfc3e336b 100644 --- a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Linux.md +++ b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Convert-PowerPoint-to-PDF-in-Linux.md @@ -49,8 +49,9 @@ dotnet add package HarfBuzzSharp.NativeAssets.Linux -v 8.3.0.1 -s https://www.nu {% endhighlight %} {% endtabs %} -N> 1. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components. -N> 2. If you are using prior to v23.1.40 release, please refer [here](https://help.syncfusion.com/document-processing/word/word-library/net/faq#what-are-the-nuget-packages-to-be-installed-to-perform-word-to-pdf-conversion-in-linux-os) to know about how to perform Word to PDF conversion in Linux. +N> 1. For other Linux environments, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for detailed information on the additional NuGet packages required. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your applications to use our components. +N> 3. If you are using prior to v23.1.40 release, please refer [here](https://help.syncfusion.com/document-processing/word/word-library/net/faq#what-are-the-nuget-packages-to-be-installed-to-perform-word-to-pdf-conversion-in-linux-os) to know about how to perform Word to PDF conversion in Linux. Step 3: Add the following Namespaces in **Program.cs** file. @@ -159,7 +160,8 @@ Step 2: Install the NuGet package from [NuGet.org](https://www.nuget.org/).  -N> Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion license key in your application to use our components. +N> 1. For other Linux environments, refer to the [documentation](https://help.syncfusion.com/document-processing/powerpoint/conversions/powerpoint-to-pdf/net/nuget-packages-required-for-pptxtopdf-conversion#additional-nuget-packages-required-for-linux) for detailed information on the additional NuGet packages required. +N> 2. Starting with v16.2.0.x, if you reference Syncfusion assemblies from trial setup or from the NuGet feed, you also have to add "Syncfusion.Licensing" assembly reference and include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion license key in your application to use our components. Step 3: Add the following Namespaces in **Program.cs** file. diff --git a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Nuget-Packages-Required-for-PPTXtoPDF-Conversion.md b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Nuget-Packages-Required-for-PPTXtoPDF-Conversion.md index e523c93e3..b6c896839 100644 --- a/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Nuget-Packages-Required-for-PPTXtoPDF-Conversion.md +++ b/Document-Processing/PowerPoint/Conversions/PowerPoint-To-PDF/NET/Nuget-Packages-Required-for-PPTXtoPDF-Conversion.md @@ -75,6 +75,8 @@ Windows UI Library (WinUI) and .NET Multi-platform App UI (.NET MAUI) +T> If you encounter issues while using the .NET PowerPoint library in ASP.NET Core, refer to the [troubleshooting guide](https://support.syncfusion.com/kb/article/16010/how-to-use-troubleshooting-guide-for-aspnet-core-powerpoint-library-issues) for recommended checks and solutions. + #### Retired Platforms The following NuGet packages need to be included in your application based on the platform. @@ -95,7 +97,49 @@ The following NuGet packages need to be included in your application based on th -N> PowerPoint Presentation to PDF conversion is supported from .NET Standard 1.4 onwards for ASP.NET Core and Xamarin. +N> 1. PowerPoint Presentation to PDF conversion is supported from .NET Standard 1.4 onwards for ASP.NET Core and Xamarin. +N> 2. Syncfusion has **deprecated the ASP.NET package**. We strongly recommend upgrading your applications to ASP.NET Core. Refer [here](https://help.syncfusion.com/document-processing/powerpoint/powerpoint-library/net/faqs/migrate-from-net-framework-to-net-core) to migrate from .NET Framework to .NET Core. + +### Additional NuGet packages required for Linux + +The SkiaSharp and HarfBuzzSharp native asset NuGet packages are required as additional dependencies when deploying your application in Linux environments. There are two types of NuGet packages—choose the appropriate ones based on your specific Linux environment. + +The following table illustrates the native assets NuGet packages and their applicable Linux environments: + +
| Required Native assets NuGet packages | +Applicable Linux environments | +
|---|---|
|
+ {{'[SkiaSharp.NativeAssets.Linux v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)'| markdownify }} + {{'[HarfBuzzSharp.NativeAssets.Linux v8.3.0.1](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.0.1)'| markdownify }} + |
+
+
|
+
| + {{'[SkiaSharp.NativeAssets.Linux.NoDependencies v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/3.116.1)'| markdownify }} + | +
+
|
+
-T> Switch to NuGet packages for a seamless experience: +T> 1. If you encounter issues while using the .NET PowerPoint library in ASP.NET Core, refer to the [troubleshooting guide](https://support.syncfusion.com/kb/article/16010/how-to-use-troubleshooting-guide-for-aspnet-core-powerpoint-library-issues) for recommended checks and solutions. +T> 2. Switch to NuGet packages for a seamless experience: T> * Get frequent bug fixes every week. T> * Upgrade quickly with no manual effort. T> Note: To avoid trail watermark when using NuGet packages, it is recommended to register license key in application. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. @@ -112,7 +113,7 @@ Syncfusion.OfficeChart.Portable
Syncfusion.Pdf.Portable
Syncfusion.PresentationRenderer.Portable
Syncfusion.Pdf.Imaging.Portable
-Syncfusion.MetafileRenderer.NET
+Syncfusion.MetafileRenderer.Portable
Syncfusion.SkiaSharpHelper.Portable
SkiaSharp diff --git a/Document-Processing/PowerPoint/PowerPoint-Library/NET/NuGet-Packages-Required.md b/Document-Processing/PowerPoint/PowerPoint-Library/NET/NuGet-Packages-Required.md index 8c369f61d..2dca4df12 100644 --- a/Document-Processing/PowerPoint/PowerPoint-Library/NET/NuGet-Packages-Required.md +++ b/Document-Processing/PowerPoint/PowerPoint-Library/NET/NuGet-Packages-Required.md @@ -1,6 +1,6 @@ --- title: Required NuGet Packages for PowerPoint library | Syncfusion -description: This section illustrates the NuGet packages required to use Syncfusion® PowerPoint library (Essential® Presentation) in various platforms and frameworks +description: This section illustrates the NuGet packages required to use Syncfusion PowerPoint library (Essential Presentation) in various platforms and frameworks platform: document-processing control: PowerPoint documentation: UG @@ -82,6 +82,8 @@ To work with PowerPoint Presentations, install the following NuGet packages in y +T> If you encounter issues while using the .NET PowerPoint library in ASP.NET Core, refer to the [troubleshooting guide](https://support.syncfusion.com/kb/article/16010/how-to-use-troubleshooting-guide-for-aspnet-core-powerpoint-library-issues) for recommended checks and solutions. + #### Retired Platforms The following NuGet packages need to be included in your application based on the platform. @@ -105,6 +107,7 @@ The following NuGet packages need to be included in your application based on th N> 1. Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, add the "Syncfusion.Licensing" assembly reference and include a license key in your projects. Refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to learn about registering Syncfusion® license key in your applications to use the components. N> 2. From the Essential Studio® 2018 Volume 3 release(v16.3.0.21), Syncfusion® has changed some of the NuGet package names to search and find the required Syncfusion® NuGet packages in nuget.org easily based on the control and its platforms. +N> 3. Syncfusion has **deprecated the ASP.NET package**. We strongly recommend upgrading your applications to ASP.NET Core. Refer [here](https://help.syncfusion.com/document-processing/powerpoint/powerpoint-library/net/faqs/migrate-from-net-framework-to-net-core) to migrate from .NET Framework to .NET Core. ## Converting PowerPoint Presentation into PDF @@ -196,6 +199,47 @@ The following NuGet packages need to be included in your application based on th N> PowerPoint Presentation to PDF conversion is supported from .NET Standard 1.4 onwards for ASP.NET Core and Xamarin. +### Additional NuGet packages required for Linux + +The SkiaSharp and HarfBuzzSharp native asset NuGet packages are required as additional dependencies when deploying your application in Linux environments. There are two types of NuGet packages—choose the appropriate ones based on your specific Linux environment. + +The following table illustrates the native assets NuGet packages and their applicable Linux environments: + +
| Required Native assets NuGet packages | +Applicable Linux environments | +
|---|---|
|
+ {{'[SkiaSharp.NativeAssets.Linux v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)'| markdownify }} + {{'[HarfBuzzSharp.NativeAssets.Linux v8.3.0.1](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.0.1)'| markdownify }} + |
+
+
|
+
| + {{'[SkiaSharp.NativeAssets.Linux.NoDependencies v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/3.116.1)'| markdownify }} + | +
+
|
+
| Required Native assets NuGet packages | +Applicable Linux environments | +
|---|---|
|
+ {{'[SkiaSharp.NativeAssets.Linux v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)'| markdownify }} + {{'[HarfBuzzSharp.NativeAssets.Linux v8.3.0.1](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.0.1)'| markdownify }} + |
+
+
|
+
| + {{'[SkiaSharp.NativeAssets.Linux.NoDependencies v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/3.116.1)'| markdownify }} + | +
+
|
+
Syncfusion.Compression.Base
Syncfusion.Of
Syncfusion.Compression.Portable
Syncfusion.OfficeChart.Portable
Syncfusion.Pdf.Portable
Syncfusion.DocIORenderer.Portable
Syncfusion.Pdf.Imaging.Portable
Syncfusion.MetafileRenderer.NET
SkiaSharp.HarfBuzz
Syncfusion.SkiaSharpHelper.Portable
Syncfusion.Compression.Portable
Syncfusion.OfficeChart.Portable
Syncfusion.Pdf.Portable
Syncfusion.DocIORenderer.Portable
Syncfusion.Pdf.Imaging.Portable
Syncfusion.MetafileRenderer.Portable
SkiaSharp.HarfBuzz
Syncfusion.SkiaSharpHelper.Portable
{{'[.NET Multi-platform App UI (.NET MAUI)](https://help.syncfusion.com/document-processing/word/conversions/word-to-image/net/convert-word-document-to-image-in-maui)' | markdownify}}
@@ -35,9 +35,10 @@ Syncfusion.DocIO.Portable
Syncfusion.Compression.Portable
Syncfusion.Off Syncfusion.DocIO.NET
Syncfusion.Compression.NET
Syncfusion.OfficeChart.NET
Syncfusion.Pdf.NET
Syncfusion.DocIORenderer.NET
Syncfusion.Pdf.Imaging.NET
Syncfusion.MetafileRenderer.NET
SkiaSharp
Syncfusion.SkiaSharpHelper.NET
| Required Native assets NuGet packages | +Applicable Linux environments | +
|---|---|
|
+ {{'[SkiaSharp.NativeAssets.Linux v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)'| markdownify }} + {{'[HarfBuzzSharp.NativeAssets.Linux v8.3.0.1](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.0.1)'| markdownify }} + |
+
+
|
+
| + {{'[SkiaSharp.NativeAssets.Linux.NoDependencies v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/3.116.1)'| markdownify }} + | +
+
|
+
| Document Element | +Limitation | +
|---|---|
| +Predefined shapes + | ++Only DOCX and WordML format documents are supported. + | +
| +Chart + | ++Only DOCX and WordML format documents are supported from .NET Framework 4.0 onwards. The following chart types are not supported: Line-Stacked Line, Line-Stacked line with markers, Pie-Pie of Pie, Pie-Bar of Pie, Map-Filled Map, Stock-Volume high low close, Stock-Volume open high low close, Surface-3D Surface, Surface-Wireframe 3D Surface, Surface-Contour, Surface-Wireframe Contour, Treemap-Treemap, Sunburst-Sunburst, Histogram-Histogram, Histogram-Pareto chart, Box & Whisker, Waterfall and Funnel. + | +
| +Grouped Shapes + | ++Only DOCX and WordML format documents are supported. + | +
| +Custom Shapes + | ++Only DrawingML custom shapes in DOCX and WordML format documents are supported. + | +
| +Equation + | ++Mathematical equations extending to multiple lines will be rendered in a single line and content exceeding the right margin will clip in the image. + | +
| +SmartArt + | ++Supported only in DOCX format document to image. Additional behavior explained {{ '[here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/unsupported-elements-word-to-pdf#smartart)' | markdownify }}. + | +
| +WordArt + | ++Not supported + | +
| +Watermark + | ++First watermark of the Word document should be applied to the entire converted PDF document when the Word document have multiple watermarks. + | +
| +Multi-Column Texts + | ++Multi-Column text positions are calculated dynamically when layout the text. So, there may be some content position differences occur in the image. + | +
| +Footnote and endnote + | ++Number formats in Roman, Alphabets, and Arabic only supported. + | +
| +Textbox + | ++Linked text boxes are not supported. + | +
| Formatting | +Limitation | +
|---|---|
| +Table Styles + | ++Only DOCX and WordML format documents are supported. + | +
| +Pagination + | ++The Essential® DocIO makes sensible decision when layout the text, and its supported elements while generating the PDF documents. But however, there may not be guaranteed pagination with all the documents. + | +
| +Fit Text - Table cell + | ++Not supported + | +
| +Vertical Alignment of the section + | ++Not supported + | +
| +Borders + | ++Using of patterns and 3D borders are not retained in the output image. + | +
| +Break - Page break, column break and Line break + | ++Text wrapping break is not supported. + | +
| +Font kerning + | ++Partially supported. At present, the text in a line is scaled uniformly to match the width of kerned text, instead of adjusting the space between each pair of characters. + | +
| +Transparency and Pattern fill in shapes + | ++Supported only in DOCX format during Word to image conversion. + | +
| +Recolor picture + | ++Supported only in DOCX format during Word to image conversion. + | +
| +Gradient fill in Shapes + | ++Supported only in DOCX format. Rectangular and Path gradient types are not supported in image conversions in ASP.NET Core, Blazor, WinUI, .NET MAUI, and Xamarin platforms. These are currently rendered as Radial gradients. + | +
Syncfusion.Compression.Base
Syncfusion.Of
Syncfusion.Compression.Portable
Syncfusion.OfficeChart.Portable
Syncfusion.Pdf.Portable
Syncfusion.DocIORenderer.Portable
Syncfusion.Pdf.Imaging.Portable
Syncfusion.MetafileRenderer.NET
SkiaSharp.HarfBuzz
Syncfusion.SkiaSharpHelper.Portable
Syncfusion.Compression.Portable
Syncfusion.OfficeChart.Portable
Syncfusion.Pdf.Portable
Syncfusion.DocIORenderer.Portable
Syncfusion.Pdf.Imaging.Portable
Syncfusion.MetafileRenderer.Portable
SkiaSharp.HarfBuzz
Syncfusion.SkiaSharpHelper.Portable
{{'[.NET Multi-platform App UI (.NET MAUI)](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/convert-word-document-to-pdf-in-maui)' | markdownify}}
@@ -35,9 +35,10 @@ Syncfusion.DocIO.Portable
Syncfusion.Compression.Portable
Syncfusion.Off Syncfusion.DocIO.NET
Syncfusion.Compression.NET
Syncfusion.OfficeChart.NET
Syncfusion.Pdf.NET
Syncfusion.DocIORenderer.NET
Syncfusion.Pdf.Imaging.NET
Syncfusion.MetafileRenderer.NET
SkiaSharp
Syncfusion.SkiaSharpHelper.NET
| Required Native assets NuGet packages | +Applicable Linux environments | +
|---|---|
|
+ {{'[SkiaSharp.NativeAssets.Linux v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)'| markdownify }} + {{'[HarfBuzzSharp.NativeAssets.Linux v8.3.0.1](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.0.1)'| markdownify }} + |
+
+
|
+
| + {{'[SkiaSharp.NativeAssets.Linux.NoDependencies v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/3.116.1)'| markdownify }} + | +
+
|
+
| Element | -Unsupported elements | +Document Element | +Limitation |
|---|---|---|---|
| -Only DOCX and WordML format documents are supported from .NET Framework 4.0 onwards. +Only DOCX and WordML format documents are supported from .NET Framework 4.0 onwards. The following chart types are not supported: Line-Stacked Line, Line-Stacked line with markers, Pie-Pie of Pie, Pie-Bar of Pie, Map-Filled Map, Stock-Volume high low close, Stock-Volume open high low close, Surface-3D Surface, Surface-Wireframe 3D Surface, Surface-Contour, Surface-Wireframe Contour, Treemap-Treemap, Sunburst-Sunburst, Histogram-Histogram, Histogram-Pareto chart, Box & Whisker, Waterfall and Funnel. | |||
| -Table Styles +Grouped Shapes | Only DOCX and WordML format documents are supported. @@ -43,31 +43,31 @@ Only DOCX and WordML format documents are supported. | ||
| -Pagination +Custom Shapes | -The Essential® DocIO makes sensible decision when layout the text, and its supported elements while generating the PDF documents. But however, there may not be guaranteed pagination with all the documents. +Only DrawingML custom shapes in DOCX and WordML format documents are supported. | ||
| -Grouped Shapes +Equation | -Only DOCX and WordML format documents are supported. +Mathematical equations extending to multiple lines will be rendered in a single line and content exceeding the right margin will clip in the PDF. | ||
| -Custom Shapes +SmartArt | -Only DrawingML custom shapes in DOCX and WordML format documents are supported. +Supported only in DOCX format document to PDF. Additional behavior explained {{ '[here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/unsupported-elements-word-to-pdf#smartart)' | markdownify }}. | ||
| -Fit Text – Table cell +WordArt | Not supported @@ -75,50 +75,75 @@ Not supported | ||
| -Vertical Alignment of the section +Watermark | -Not supported +First watermark of the Word document should be applied to the entire converted PDF document when the Word document have multiple watermarks. | ||
| -Equation +Multi-Column Texts | -Mathematical equations extending to multiple lines will be rendered in a single line and content exceeding the right margin will clip in the PDF. +Multi-Column text positions are calculated dynamically when layout the text. So, there may be some content position differences occur in the PDF document. | ||
| -SmartArt +Footnote and endnote | -Not supported +Number formats in Roman, Alphabets, and Arabic only supported. | ||
| -WordArt +Textbox | -Not supported +Linked text boxes are not supported. |
| Formatting | +Limitation | +
|---|---|
| -Watermark +Table Styles | -First watermark of the Word document should be applied to the entire converted PDF document when the Word document have multiple watermarks. +Only DOCX and WordML format documents are supported. |
| -Multi-Column Texts +Pagination | -Multi-Column text positions are calculated dynamically when layout the text. So, there may be some content position differences occur in the PDF document. +The Essential® DocIO makes sensible decision when layout the text, and its supported elements while generating the PDF documents. But however, there may not be guaranteed pagination with all the documents. + | +
| +Fit Text - Table cell + | ++Not supported + | +
| +Vertical Alignment of the section + | ++Not supported |
| -Footnote and endnote +Font kerning | -Number formats in Roman, Alphabets, and Arabic only supported. +Partially supported. At present, the text in a line is scaled uniformly to match the width of kerned text, instead of adjusting the space between each pair of characters. |
| -Textbox +Transparency and Pattern fill in shapes | -Linked text boxes are not supported. +Supported only in DOCX format during Word to PDF conversion. |
| -Font kerning +Recolor picture | -Partially supported. At present, the text in a line is scaled uniformly to match the width of kerned text, instead of adjusting the space between each pair of characters. +Supported only in DOCX format during Word to PDF conversion. + | +
| +Gradient fill in Shapes + | ++Supported only in DOCX format. Rectangular and Path gradient types are not supported in PDF conversions in ASP.NET Core, Blazor, WinUI, .NET MAUI, and Xamarin platforms. These are currently rendered as Radial gradients. + | +
| +Metafile images (WMF, EMF) + | ++Supported. Text within WMF or EMF images is searchable in the converted PDF only when the image is not cropped, recolored, or made transparent. |
Syncfusion.OfficeChart.UWP
Syncfusion.DocIO.NET
Syncfusion.Compression.NET
Syncfusion.OfficeChart.NET
-T> Switch to NuGet packages for a seamless experience: -T> * Get frequent bug fixes every week. -T> * Upgrade quickly with no manual effort. +T> 1. If you encounter issues while using the .NET Word library in ASP.NET Core, refer to the [troubleshooting guide](https://support.syncfusion.com/kb/article/16012/troubleshoot-guide-for-aspnet-core-word-docio-library-issues#things-to-check-while-facing-an-issue-in-word-library) for recommended checks and solutions. +T> 2. Switch to NuGet packages for a seamless experience: +T> * Get frequent bug fixes every week. +T> * Upgrade quickly with no manual effort. T> Note: To avoid trail watermark when using NuGet packages, it is recommended to register license key in application. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/overview) to know about registering Syncfusion® license key in your application to use our components. T> T> Refer [here](https://help.syncfusion.com/document-processing/word/word-library/net/nuget-packages-required) to know more about NuGet packages required. @@ -119,7 +120,7 @@ Syncfusion.DocIO.ClientProfile
Syncfusion.Compression.Base
Syncfusion.Of
Syncfusion.Compression.Portable
Syncfusion.OfficeChart.Portable
Syncfusion.Pdf.Portable
Syncfusion.DocIORenderer.Portable
Syncfusion.Pdf.Imaging.Portable
Syncfusion.MetafileRenderer.NET
SkiaSharp.HarfBuzz
Syncfusion.SkiaSharpHelper.Portable
Syncfusion.Compression.Portable
Syncfusion.OfficeChart.Portable
Syncfusion.Pdf.Portable
Syncfusion.DocIORenderer.Portable
Syncfusion.Pdf.Imaging.Portable
Syncfusion.MetafileRenderer.Portable
SkiaSharp.HarfBuzz
Syncfusion.SkiaSharpHelper.Portable
{{'[.NET Multi-platform App UI (.NET MAUI)](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/convert-word-document-to-pdf-in-maui)' | markdownify}}
diff --git a/Document-Processing/Word/Word-Library/NET/FAQ.md b/Document-Processing/Word/Word-Library/NET/FAQ.md index 8cfeb1314..c1fd637c0 100644 --- a/Document-Processing/Word/Word-Library/NET/FAQ.md +++ b/Document-Processing/Word/Word-Library/NET/FAQ.md @@ -29,6 +29,13 @@ The frequently asked questions under each category in Essential® * [How to view Word documents in my .NET MAUI application using DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-document-faqs#how-to-view-word-documents-in-my-net-maui-application-using-docio) * [How to identify if a Word document is in portrait or landscape?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-document-faqs#how-to-identify-if-a-word-document-is-in-portrait-or-landscape) * [How to save the Word document with same compatibility using DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#saving-word-document-with-compatibility) +* [How to create a Word document using DocIO in a python wrapper-based web API using .NET Core Word library?](https://support.syncfusion.com/kb/article/20139/how-to-create-a-word-document-using-docio-in-aspnet-core) +* [How to integrate DocIO functionality in Node.js using ASP.NET Core Web API?](https://support.syncfusion.com/kb/article/20317/how-to-integrate-docio-functionality-in-nodejs-using-aspnet-core-web-api) +* [Is it possible to fetch the page number of Word document elements using DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-document-faqs#is-it-possible-to-fetch-the-page-number-of-word-document-elements-using-docio) +* [Is it possible to download a Word document from an AWS S3 bucket and use it in DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-document-faqs#is-it-possible-to-download-a-word-document-from-an-aws-s3-bucket-and-use-it-in-docio) +* [Can DocIO open or process MPIP-protected Word documents?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-document-faqs#can-docio-open-or-process-mpip-protected-word-documents) +* [Why does content imported from one Word document to another start on a new page, even without a section break?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-document-faqs#why-does-content-imported-from-one-word-document-to-another-start-on-a-new-page-even-without-a-section-break) +* [Does DocIO process corrupted Word documents?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-document-faqs#does-docio-process-corrupted-word-documents) ## Sections @@ -52,6 +59,11 @@ The frequently asked questions under each category in Essential® * [Can the border radius be set for shapes in a Word document?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/paragraph-and-paragraph-items-faqs#can-the-border-radius-be-set-for-shapes-in-a-word-document) * [Why is the UpdateTableOfContents() method not accessible in a cross-platform application?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/paragraph-and-paragraph-items-faqs#why-is-the-updatetableofcontents-method-not-accessible-in-a-cross-platform-application) * [Why does the item index in a Word document differ from the DocIO library?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/paragraph-and-paragraph-items-faqs#why-does-the-item-index-in-a-word-document-differ-from-the-docio-library) +* [Is it possible to create a Spline chart in a Word document using DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/paragraph-and-paragraph-items-faqs#is-it-possible-to-create-a-spline-chart-in-a-word-document-using-docio) +* [Why does an exception occur while manipulating found text using Find APIs?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/paragraph-and-paragraph-items-faqs#why-does-an-exception-occur-while-manipulating-found-text-using-find-apis) +* [Why is some text not found in a Word document when using the Find functionality in DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/paragraph-and-paragraph-items-faqs#why-is-some-text-not-found-in-a-word-document-when-using-the-find-functionality-in-docio) +* [Why is a bookmark name with a hyphen (-) converted to an underscore (_) in DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/paragraph-and-paragraph-items-faqs#why-is-a-bookmark-name-with-a-hyphen---converted-to-an-underscore-_-in-docio) +* [Why is formatting not preserved after calling GetAsOneRange()?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/paragraph-and-paragraph-items-faqs#why-is-formatting-not-preserved-after-calling-getasonerange) ## Mail merge @@ -59,6 +71,8 @@ The frequently asked questions under each category in Essential® * [Why does DocIO use merge field values from the parent group when the nested group data does not contain a value?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/mail-merge-faqs#why-does-docio-use-merge-field-values-from-the-parent-group-when-the-nested-group-data-does-not-contain-a-value) * [How to identify merge fields that do not exist in the data source?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/mail-merge-faqs#how-to-identify-merge-fields-that-do-not-exist-in-the-data-source) * [Why is each record merging on a new page during mail merge?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/mail-merge-faqs#why-is-each-record-merging-on-a-new-page-during-mail-merge) +* [Why does TryAdd() not work with ExpandoObject in .NET Framework 4.8?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/mail-merge-faqs#why-does-tryadd-not-work-with-expandoobject-in-net-framework-48) +* [Why do merge fields disappear when running mail merge multiple times?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/mail-merge-faqs#why-do-merge-fields-disappear-when-running-mail-merge-multiple-times) ## Tables @@ -71,6 +85,7 @@ The frequently asked questions under each category in Essential® * [Why does setting the top or bottom padding for one cell in a Word document apply the same padding to all cells in the row?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/tables-faqs#why-does-setting-the-top-or-bottom-padding-for-one-cell-in-a-word-document-apply-the-same-padding-to-all-cells-in-the-row) * [Is it possible to insert a page break inside a table using DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/tables-faqs#is-it-possible-to-insert-a-page-break-inside-a-table-using-docio) * [How to access a specific cell in a table in a Word document?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/tables-faqs#how-to-access-a-specific-cell-in-a-table-in-a-word-document) +* [Is it possible to access and edit the content of a table in a Word document?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/tables-faqs#is-it-possible-to-access-and-edit-the-content-of-a-table-in-a-word-document) ## Track Changes @@ -79,6 +94,7 @@ The frequently asked questions under each category in Essential® * [How to enable track changes for Word document?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/track-changes-faqs#how-to-enable-track-changes-for-word-document) * [What happens when Word documents with track changes are used for comparing?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/track-changes-faqs#what-happens-when-word-documents-with-track-changes-are-used-for-comparing) * [Why track changes color are different in Word document?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/track-changes-faqs#why-track-changes-color-are-different-in-word-document) +* [Is it possible to track changes made programmatically using the DocIO library?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/track-changes-faqs#is-it-possible-to-track-changes-made-programmatically-using-the-docio-library) ## Word to PDF and Image conversions @@ -95,6 +111,16 @@ The frequently asked questions under each category in Essential® * [Will the same fonts be rendered when exporting a document to a PDF file?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#will-the-same-fonts-be-rendered-when-exporting-a-document-to-a-pdf-file) * [Why is the chart not preserved during Word-to-PDF or image conversion in .NET Framework?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#why-is-the-chart-not-preserved-during-word-to-pdf-or-image-conversion-in-net-framework) * [How to convert Word document to PDF/A?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#how-to-convert-word-document-to-pdfa) +* [How to validate the PDF conformance level in a DocIO-converted PDF?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#how-to-validate-the-pdf-conformance-level-in-a-docio-converted-pdf) +* [Why does memory usage appear high in Visual Studio after converting a Word document to PDF using DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#why-does-memory-usage-appear-high-in-visual-studio-after-converting-a-word-document-to-pdf-using-docio) +* [Is it possible to substitute fonts in a Word document?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#is-it-possible-to-substitute-fonts-in-a-word-document) +* [How does hyphenation work in Microsoft Word compared to Syncfusion® DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#how-does-hyphenation-work-in-microsoft-word-compared-to-syncfusion-docio) +* [How to identify the language of a specific word in a Word document?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#how-to-identify-the-language-of-a-specific-word-in-a-word-document) +* [Why does hyphenation appear incorrectly or missing in the converted PDF?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#why-does-hyphenation-appear-incorrectly-or-missing-in-the-converted-pdf) +* [How to improve hyphenation accuracy during Word to PDF conversion?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#how-to-improve-hyphenation-accuracy-during-word-to-pdf-conversion) +* [How to set custom Image Resolution in ASP.NET Core?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#how-to-set-custom-image-resolution-in-aspnet-core) +* [What languages and Unicode support are available in the DocIO library?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#what-languages-and-unicode-support-are-available-in-the-docio-library) +* [What are Web Layout View and Print Layout View in Microsoft Word, and which one does DocIO use for PDF conversion?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/word-to-pdf-and-image-conversions-faqs#what-are-web-layout-view-and-print-layout-view-in-microsoft-word-and-which-one-does-docio-use-for-pdf-conversion) ## HTML and EPUB conversions @@ -105,6 +131,10 @@ The frequently asked questions under each category in Essential® * [Why does Syncfusion.Drawing.ColorTranslator.FromHtml not parse #rrggbbaa hex color notation correctly?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/html-and-epub-conversions-faqs#why-does-syncfusiondrawingcolortranslatorfromhtml-not-parse-rrggbbaa-hex-color-notation-correctly) * [How to verify whether styles and formatting in HTML are valid?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/html-and-epub-conversions-faqs#how-to-verify-whether-styles-and-formatting-in-html-are-valid) * [How does AppendHtml() handle multiple paragraphs in an HTML string?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/html-and-epub-conversions-faqs#how-does-appendhtml-handle-multiple-paragraphs-in-an-html-string) +* [Why do multi-column layouts in Word documents not appear correctly in HTML after conversion?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/html-and-epub-conversions-faqs#why-do-multi-column-layouts-in-word-documents-not-appear-correctly-in-html-after-conversion) +* [How to apply custom fonts and sizes to mathematical equations in a Word document using DocIO?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/html-and-epub-conversions-faqs#how-to-apply-custom-fonts-and-sizes-to-mathematical-equations-in-a-word-document-using-docio) +* [Why does a URL-referenced image show as a red X after appending HTML?](https://help.syncfusion.com/document-processing/word/word-library/net/faqs/html-and-epub-conversions-faqs#why-does-a-url-referenced-image-show-as-a-red-x-after-appending-html) +* [How to preserve `
| Required Native assets NuGet packages | +Applicable Linux environments | +
|---|---|
|
+ {{'[SkiaSharp.NativeAssets.Linux v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)'| markdownify }} + {{'[HarfBuzzSharp.NativeAssets.Linux v8.3.0.1](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.0.1)'| markdownify }} + |
+
+
|
+
| + {{'[SkiaSharp.NativeAssets.Linux.NoDependencies v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/3.116.1)'| markdownify }} + | +
+
|
+
| Required Native assets NuGet packages | +Applicable Linux environments | +
|---|---|
|
+ {{'[SkiaSharp.NativeAssets.Linux v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux/3.116.1)'| markdownify }} + {{'[HarfBuzzSharp.NativeAssets.Linux v8.3.0.1](https://www.nuget.org/packages/HarfBuzzSharp.NativeAssets.Linux/8.3.0.1)'| markdownify }} + |
+
+
|
+
| + {{'[SkiaSharp.NativeAssets.Linux.NoDependencies v3.116.1](https://www.nuget.org/packages/SkiaSharp.NativeAssets.Linux.NoDependencies/3.116.1)'| markdownify }} + | +
+
|
+
| Source Format | +Destination Format | +|||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| -Source Format - | --{{'[DOC](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-binary-97-2003-format)'| markdownify }} +{{'[DOC](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-binary-97-2003-format)'| markdownify }} | -{{'[DOCX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#doc-to-docx-and-docx-to-doc)'| markdownify }} +{{'[DOCX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#doc-to-docx-and-docx-to-doc)'| markdownify }} | -{{'[Word Processing XML (2007)](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-open-xml-formats-2007--later)'| markdownify }} +{{'[Word Processing XML (2007)](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-open-xml-formats-2007--later)'| markdownify }} | -{{'[DOT](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#templates)'| markdownify }} +{{'[DOT](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#templates)'| markdownify }} | -{{'[DOTX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#templates)'| markdownify }} +{{'[DOTX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#templates)'| markdownify }} | -{{'[DOCM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros)'| markdownify }} +{{'[DOCM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros)'| markdownify }} | -{{'[DOTM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros)'| markdownify }} +{{'[DOTM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros)'| markdownify }} | -{{'[ODT](https://help.syncfusion.com/document-processing/word/word-library/net/word-to-odt)'| markdownify }} +{{'[ODT](https://help.syncfusion.com/document-processing/word/word-library/net/word-to-odt)'| markdownify }} | -{{'[RTF](https://help.syncfusion.com/document-processing/word/word-library/net/rtf)'| markdownify }} +{{'[RTF](https://help.syncfusion.com/document-processing/word/word-library/net/rtf)'| markdownify }} | -{{'[Text](https://help.syncfusion.com/document-processing/word/word-library/net/text)'| markdownify }} +{{'[Text](https://help.syncfusion.com/document-processing/word/word-library/net/text)'| markdownify }} | -{{'[Markdown](https://help.syncfusion.com/document-processing/word/word-library/net/convert-word-document-to-markdown-in-csharp)'| markdownify }} +{{'[Markdown](https://help.syncfusion.com/document-processing/word/word-library/net/convert-word-document-to-markdown-in-csharp)'| markdownify }} | -{{'[HTML](https://help.syncfusion.com/document-processing/word/word-library/net/html)'| markdownify }} +{{'[HTML](https://help.syncfusion.com/document-processing/word/word-library/net/html)'| markdownify }} | -{{'[PDF](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/word-to-pdf)'| markdownify }} +{{'[PDF](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/word-to-pdf)'| markdownify }} | -{{'[Image](https://help.syncfusion.com/document-processing/word/conversions/word-to-image/net/word-to-image)'| markdownify }} +{{'[Image](https://help.syncfusion.com/document-processing/word/conversions/word-to-image/net/word-to-image)'| markdownify }} |
| {{'[DOC](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-binary-97-2003-format)'| markdownify }} | +{{'[DOC](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-binary-97-2003-format)'| markdownify }} | Yes | Yes | Yes | @@ -78,7 +79,7 @@ Source FormatYes | |||||||||
| {{'[DOCX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#doc-to-docx-and-docx-to-doc)'| markdownify }} | +{{'[DOCX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#doc-to-docx-and-docx-to-doc)'| markdownify }} | Yes | Yes | Yes | @@ -95,7 +96,7 @@ Source FormatYes | |||||||||
| {{'[Word Processing XML (2003)](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-processing-xml-xml)'| markdownify }} | +{{'[Word Processing XML (2003)](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-processing-xml-xml)'| markdownify }} | Yes | Yes | Yes | @@ -112,7 +113,7 @@ Source FormatYes | |||||||||
| {{'[Word Processing XML (2007)](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-open-xml-formats-2007--later)'| markdownify }} | +{{'[Word Processing XML (2007)](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#word-open-xml-formats-2007--later)'| markdownify }} | Yes | Yes | Yes | @@ -129,7 +130,7 @@ Source FormatYes | |||||||||
| {{'[DOT](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#templates)'| markdownify }} | +{{'[DOT](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#templates)'| markdownify }} | Yes | Yes | Yes | @@ -146,7 +147,7 @@ Source FormatYes | |||||||||
| {{'[DOTX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#templates)'| markdownify }} | +{{'[DOTX](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#templates)'| markdownify }} | Yes | Yes | Yes | @@ -163,7 +164,7 @@ Source FormatYes | |||||||||
| {{'[DOCM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros)'| markdownify }} | +{{'[DOCM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros)'| markdownify }} | Yes | Yes | Yes | @@ -180,7 +181,7 @@ Source FormatYes | |||||||||
| {{'[DOTM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros)'| markdownify }} | +{{'[DOTM](https://help.syncfusion.com/document-processing/word/word-library/net/word-file-formats#macros)'| markdownify }} | Yes | Yes | Yes | @@ -197,7 +198,7 @@ Source FormatYes | |||||||||
| {{'[RTF](https://help.syncfusion.com/document-processing/word/word-library/net/rtf)'| markdownify }} | +{{'[RTF](https://help.syncfusion.com/document-processing/word/word-library/net/rtf)'| markdownify }} | Yes | Yes | Yes | @@ -214,7 +215,7 @@ Source FormatYes | |||||||||
| {{'[Text](https://help.syncfusion.com/document-processing/word/word-library/net/text)'| markdownify }} | +{{'[Text](https://help.syncfusion.com/document-processing/word/word-library/net/text)'| markdownify }} | Yes | Yes | Yes | @@ -231,7 +232,7 @@ Source FormatYes | |||||||||
| {{'[Markdown](https://help.syncfusion.com/document-processing/word/word-library/net/convert-markdown-to-word-document-in-csharp)'| markdownify }} | +{{'[Markdown](https://help.syncfusion.com/document-processing/word/word-library/net/convert-markdown-to-word-document-in-csharp)'| markdownify }} | Yes | Yes | Yes | @@ -248,7 +249,7 @@ Source FormatYes | |||||||||
| {{'[HTML](https://help.syncfusion.com/document-processing/word/word-library/net/html)'| markdownify }} | +{{'[HTML](https://help.syncfusion.com/document-processing/word/word-library/net/html)'| markdownify }} | Yes | Yes | Yes | diff --git a/Document-Processing/Word/Word-Library/NET/Supported-and-Unsupported-Features.md b/Document-Processing/Word/Word-Library/NET/Supported-and-Unsupported-Features.md index 5fca28e68..5f0387230 100644 --- a/Document-Processing/Word/Word-Library/NET/Supported-and-Unsupported-Features.md +++ b/Document-Processing/Word/Word-Library/NET/Supported-and-Unsupported-Features.md @@ -382,8 +382,17 @@ No
No |
No |
-DOCX only |
-DOCX only |
+DOCX format only. Additional behavior explained {{'[here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/unsupported-elements-word-to-pdf#smartart)'| markdownify }}. |
+DOCX format only. Additional behavior explained {{'[here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/unsupported-elements-word-to-pdf#smartart)'| markdownify }}. |
+No |
+No |
+||
|
+Drawing Canvas |
+No |
+No |
+DOCX format only. Additional behavior explained {{'[here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/unsupported-elements-word-to-pdf#drawing-canvas)'| markdownify }}. |
+DOCX format only. Additional behavior explained {{'[here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/unsupported-elements-word-to-pdf#drawing-canvas)'| markdownify }}. |
No |
No | ||||||||
| {{ '[Find(string given, bool caseSensitive, bool wholeWord)](https://help.syncfusion.com/cr/file-formats/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_Find_System_String_System_Boolean_System_Boolean_)' | markdownify }} | Finds the text based on specified string, taking into the consideration of caseSensitive and wholeWord options. | -{{ '[Find first occurrence using string example.](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-find-next)' | markdownify }} | +{{ '[Find first occurrence using string example.](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-text-in-Word-document)' | markdownify }} | |||||||||||
| {{ '[Find(Regex pattern)](https://help.syncfusion.com/cr/file-formats/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_Find_System_Text_RegularExpressions_Regex_)' | markdownify }} | @@ -45,7 +45,7 @@ The following table illustrates the supported overloads for Find and Replace fun||||||||||||||
| {{ '[FindNext(TextBodyItem startTextBodyItem, string given, bool caseSensitive, bool wholeWord)](https://help.syncfusion.com/cr/file-formats/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindNext_Syncfusion_DocIO_DLS_TextBodyItem_System_String_System_Boolean_System_Boolean_)' | markdownify }} | Finds the next entry of the specified text from the specified text body item, taking into the consideration of caseSensitive and wholeWord options. | -{{ '[Find next occurrence using string example.](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-find-next)' | markdownify }} | +{{ '[Find next occurrence using string example.](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-next)' | markdownify }} | |||||||||||
| {{ '[FindNext(TextBodyItem startBodyItem, Regex pattern)](https://help.syncfusion.com/cr/file-formats/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindNext_Syncfusion_DocIO_DLS_TextBodyItem_System_Text_RegularExpressions_Regex_)' | markdownify }} | @@ -167,15 +167,15 @@ The following table illustrates the supported overloads for Find and Replace fun ## Finding contents in a Word document -You can find the first occurrence of a particular text within a single paragraph in the document by using [Find](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_Find_System_String_System_Boolean_System_Boolean_) method and its next occurrence by using [FindNext](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindNext_Syncfusion_DocIO_DLS_TextBodyItem_System_String_System_Boolean_System_Boolean_) method. You can also find a particular text pattern in the document. +You can find the first occurrence of a particular text within a single paragraph in the document by using [Find](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_Find_System_String_System_Boolean_System_Boolean_) method. You can also find a particular text pattern in the document. -The following code example illustrates how to find a particular text and its next occurrence in the document. +The following code example illustrates how to find a particular text in the document. N> Refer to the appropriate tabs in the code snippets section: ***C# [Cross-platform]*** for ASP.NET Core, Blazor, Xamarin, UWP, .NET MAUI, and WinUI; ***C# [Windows-specific]*** for WinForms and WPF; ***VB.NET [Windows-specific]*** for VB.NET applications. {% tabs %} -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Find-and-Replace/Find-and-find-next/.NET/Find-and-find-next/Program.cs" %} +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Find-and-Replace/Find-text-in-Word-document/.NET/Find-text-in-Word-document/Program.cs" %} //Loads the template document FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); @@ -187,12 +187,6 @@ WTextRange textRange = textSelection.GetAsOneRange(); textRange.Text = "Replaced text"; //Sets highlight color textRange.CharacterFormat.HighlightColor = Color.Yellow; -//Finds the next occurrence of a particular text from the previous paragraph -textSelection = document.FindNext(textRange.OwnerParagraph, "paragraph", true, false); -//Gets the found text as single text range -WTextRange range = textSelection.GetAsOneRange(); -//Sets bold formatting -range.CharacterFormat.Bold = true; //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); @@ -211,12 +205,6 @@ WTextRange textRange = textSelection.GetAsOneRange(); textRange.Text = "Replaced text"; //Sets highlight color textRange.CharacterFormat.HighlightColor = Color.Yellow; -//Finds the next occurrence of a particular text from the previous paragraph -textSelection = document.FindNext(textRange.OwnerParagraph, "paragraph", true, false); -//Gets the found text as single text range -WTextRange range = textSelection.GetAsOneRange(); -//Sets bold formatting -range.CharacterFormat.Bold = true; //Saves and closes the document document.Save("Sample.docx", FormatType.Docx); document.Close(); @@ -233,12 +221,67 @@ Dim textRange As WTextRange = textSelection.GetAsOneRange() textRange.Text = "Replaced text" 'Sets highlight color textRange.CharacterFormat.HighlightColor = Color.Yellow -'Finds the next occurrence of a particular text from the previous paragraph -textSelection = document.FindNext(textRange.OwnerParagraph, "paragraph", True, False) +'Saves and closes the document +document.Save("Sample.docx", FormatType.Docx) +document.Close() +{% endhighlight %} + +{% endtabs %} + +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-text-in-Word-document). + +### Match case + +The following code example illustrates how to find a particular text by matching case in the document. + +{% tabs %} + +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Find-and-Replace/Find-match-case/.NET/Find-match-case/Program.cs" %} +//Loads the template document +FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); +WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); +//Finds the first occurrence of a particular text in the document +TextSelection textSelection = document.Find("adventure", true, false); +//Gets the found text as single text range +WTextRange textRange = textSelection.GetAsOneRange(); +//Modifies the text +textRange.Text = "Replaced text"; +//Sets highlight color +textRange.CharacterFormat.HighlightColor = Color.Yellow; +//Saves the Word document to MemoryStream +MemoryStream stream = new MemoryStream(); +document.Save(stream, FormatType.Docx); +//Closes the document +document.Close(); +{% endhighlight %} + +{% highlight c# tabtitle="C# [Windows-specific]" %} +//Loads the template document +WordDocument document = new WordDocument("Template.docx", FormatType.Docx); +//Finds the first occurrence of a particular text in the document +TextSelection textSelection = document.Find("adventure", true, false); +//Gets the found text as single text range +WTextRange textRange = textSelection.GetAsOneRange(); +//Modifies the text +textRange.Text = "Replaced text"; +//Sets highlight color +textRange.CharacterFormat.HighlightColor = Color.Yellow; +//Saves and closes the document +document.Save("Sample.docx", FormatType.Docx); +document.Close(); +{% endhighlight %} + +{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} +'Loads the template document +Dim document As New WordDocument("Template.docx", FormatType.Docx) +'Find the first occurrence of a particular text in the document +Dim textSelection As TextSelection = document.Find("adventure", true, false) 'Gets the found text as single text range -Dim range As WTextRange = textSelection.GetAsOneRange() -'Sets bold formatting -range.CharacterFormat.Bold = True +Dim textRange As WTextRange = textSelection.GetAsOneRange() +'Modifies the text +textRange.Text = "Replaced text" +'Sets highlight color +textRange.CharacterFormat.HighlightColor = Color.Yellow 'Saves and closes the document document.Save("Sample.docx", FormatType.Docx) document.Close() @@ -246,26 +289,26 @@ document.Close() {% endtabs %} -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-find-next). +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-match-case). -You can find all the occurrence of a particular text within a single paragraph in the document by using [FindAll](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindAll_System_String_System_Boolean_System_Boolean_) method. +### Whole words only -The following code example illustrates how to find all the occurrences of a particular text in the document. +The following code example illustrates how to find a whole word in the document. {% tabs %} -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Find-and-Replace/Find-and-highlight-all/.NET/Find-and-highlight-all/Program.cs" %} +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Find-and-Replace/Find-whole-words-only/.NET/Find-whole-words-only/Program.cs" %} //Loads the template document FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); -//Finds all the occurrences of a particular text -TextSelection[] textSelections = document.FindAll("paragraph", false, true); -foreach (TextSelection textSelection in textSelections) -{ - //Gets the found text as single text range and sets highlight color - WTextRange textRange = textSelection.GetAsOneRange(); - textRange.CharacterFormat.HighlightColor = Color.YellowGreen; -} +//Finds the first occurrence of a particular text in the document +TextSelection textSelection = document.Find("AdventureWorks", false, true); +//Gets the found text as single text range +WTextRange textRange = textSelection.GetAsOneRange(); +//Modifies the text +textRange.Text = "Replaced text"; +//Sets highlight color +textRange.CharacterFormat.HighlightColor = Color.Yellow; //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); @@ -276,14 +319,14 @@ document.Close(); {% highlight c# tabtitle="C# [Windows-specific]" %} //Loads the template document WordDocument document = new WordDocument("Template.docx", FormatType.Docx); -//Finds all the occurrences of a particular text -TextSelection[] textSelections = document.FindAll("paragraph", false, true); -foreach (TextSelection textSelection in textSelections) -{ - //Gets the found text as single text range and sets highlight color - WTextRange textRange = textSelection.GetAsOneRange(); - textRange.CharacterFormat.HighlightColor = Color.YellowGreen; -} +//Finds the first occurrence of a particular text in the document +TextSelection textSelection = document.Find("AdventureWorks", false, true); +//Gets the found text as single text range +WTextRange textRange = textSelection.GetAsOneRange(); +//Modifies the text +textRange.Text = "Replaced text"; +//Sets highlight color +textRange.CharacterFormat.HighlightColor = Color.Yellow; //Saves and closes the document document.Save("Sample.docx", FormatType.Docx); document.Close(); @@ -292,13 +335,14 @@ document.Close(); {% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Loads the template document Dim document As New WordDocument("Template.docx", FormatType.Docx) -'Finds all the occurrences of a particular text -Dim textSelections As TextSelection() = document.FindAll("paragraph", False, True) -For Each textSelection As TextSelection In textSelections - 'Gets the found text as single text range and sets highlight color - Dim textRange As WTextRange = textSelection.GetAsOneRange() - textRange.CharacterFormat.HighlightColor = Color.YellowGreen -Next +'Find the first occurrence of a particular text in the document +Dim textSelection As TextSelection = document.Find("AdventureWorks", false, true) +'Gets the found text as single text range +Dim textRange As WTextRange = textSelection.GetAsOneRange() +'Modifies the text +textRange.Text = "Replaced text" +'Sets highlight color +textRange.CharacterFormat.HighlightColor = Color.Yellow 'Saves and closes the document document.Save("Sample.docx", FormatType.Docx) document.Close() @@ -306,36 +350,32 @@ document.Close() {% endtabs %} -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-highlight-all). +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-whole-words-only). -You can find the first occurrence of a particular text extended to several paragraphs in the document by using [FindSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindSingleLine_System_String_System_Boolean_System_Boolean_) method and its next occurrence by using [FindNextSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindNextSingleLine_Syncfusion_DocIO_DLS_TextBodyItem_System_String_System_Boolean_System_Boolean_) method. +### Find next occurrence -The following code example illustrates how to find a particular text extended to several paragraphs in the Word document. +The following code example illustrates how to find the next occurrence in the document. {% tabs %} -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Find-and-Replace/Find-and-find-next-paragraphs/.NET/Find-and-find-next-paragraphs/Program.cs" %} +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Find-and-Replace/Find-next/.NET/Find-next/Program.cs" %} //Loads the template document FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); -//Finds the first occurrence of a particular text extended to several paragraphs in the document -TextSelection[] textSelections = document.FindSingleLine("First paragraph Second paragraph", true, false); -WParagraph paragraph = null; -foreach (TextSelection textSelection in textSelections) -{ - //Gets the found text as single text range and set highlight color - WTextRange textRange = textSelection.GetAsOneRange(); - textRange.CharacterFormat.HighlightColor = Color.YellowGreen; - paragraph = textRange.OwnerParagraph; -} -//Finds the next occurrence of a particular text extended to several paragraphs in the document -textSelections = document.FindNextSingleLine(paragraph, "First paragraph Second paragraph", true, false); -foreach (TextSelection textSelection in textSelections) -{ - //Gets the found text as single text range and sets italic formatting - WTextRange text = textSelection.GetAsOneRange(); - text.CharacterFormat.Italic = true; -} +//Finds the first occurrence of a particular text in the document +TextSelection textSelection = document.Find("as graphical contents", false, true); +//Gets the found text as single text range +WTextRange textRange = textSelection.GetAsOneRange(); +//Modifies the text +textRange.Text = "Replaced text"; +//Sets highlight color +textRange.CharacterFormat.HighlightColor = Color.Yellow; +//Finds the next occurrence of a particular text from the previous paragraph +textSelection = document.FindNext(textRange.OwnerParagraph, "paragraph", true, false); +//Gets the found text as single text range +WTextRange range = textSelection.GetAsOneRange(); +//Sets bold formatting +range.CharacterFormat.Bold = true; //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); @@ -346,24 +386,20 @@ document.Close(); {% highlight c# tabtitle="C# [Windows-specific]" %} //Loads the template document WordDocument document = new WordDocument("Template.docx", FormatType.Docx); -//Finds the first occurrence of a particular text extended to several paragraphs in the document -TextSelection[] textSelections = document.FindSingleLine("First paragraph Second paragraph", true, false); -WParagraph paragraph = null; -foreach (TextSelection textSelection in textSelections) -{ - //Gets the found text as single text range and set highlight color - WTextRange textRange = textSelection.GetAsOneRange(); - textRange.CharacterFormat.HighlightColor = Color.YellowGreen; - paragraph = textRange.OwnerParagraph; -} -//Finds the next occurrence of a particular text extended to several paragraphs in the document -textSelections = document.FindNextSingleLine(paragraph, "First paragraph Second paragraph", true, false); -foreach (TextSelection textSelection in textSelections) -{ - //Gets the found text as single text range and sets italic formatting - WTextRange text = textSelection.GetAsOneRange(); - text.CharacterFormat.Italic = true; -} +//Finds the first occurrence of a particular text in the document +TextSelection textSelection = document.Find("as graphical contents", false, true); +//Gets the found text as single text range +WTextRange textRange = textSelection.GetAsOneRange(); +//Modifies the text +textRange.Text = "Replaced text"; +//Sets highlight color +textRange.CharacterFormat.HighlightColor = Color.Yellow; +//Finds the next occurrence of a particular text from the previous paragraph +textSelection = document.FindNext(textRange.OwnerParagraph, "paragraph", true, false); +//Gets the found text as single text range +WTextRange range = textSelection.GetAsOneRange(); +//Sets bold formatting +range.CharacterFormat.Bold = true; //Saves and closes the document document.Save("Sample.docx", FormatType.Docx); document.Close(); @@ -372,22 +408,20 @@ document.Close(); {% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Loads the template document Dim document As New WordDocument("Template.docx", FormatType.Docx) -'Finds the first occurrence of a particular text extended to several paragraphs in the document -Dim textSelections As TextSelection() = document.FindSingleLine("First paragraph Second paragraph", True, False) -Dim paragraph As WParagraph = Nothing -For Each textSelection As TextSelection In textSelections - 'Gets the found text as single text range and sets highlight color - Dim textRange As WTextRange = textSelection.GetAsOneRange() - textRange.CharacterFormat.HighlightColor = Color.YellowGreen - paragraph = textRange.OwnerParagraph -Next -'Finds the next occurrence of a particular text extended to several paragraphs in the document -textSelections = document.FindNextSingleLine(paragraph, "First paragraph Second paragraph", True, False) -For Each textSelection As TextSelection In textSelections - 'Gets the found text as single text range and sets italic formatting - Dim text As WTextRange = textSelection.GetAsOneRange() - text.CharacterFormat.Italic = True -Next +'Find the first occurrence of a particular text in the document +Dim textSelection As TextSelection = document.Find("as graphical contents", False, True) +'Gets the found text as single text range +Dim textRange As WTextRange = textSelection.GetAsOneRange() +'Modifies the text +textRange.Text = "Replaced text" +'Sets highlight color +textRange.CharacterFormat.HighlightColor = Color.Yellow +'Finds the next occurrence of a particular text from the previous paragraph +textSelection = document.FindNext(textRange.OwnerParagraph, "paragraph", True, False) +'Gets the found text as single text range +Dim range As WTextRange = textSelection.GetAsOneRange() +'Sets bold formatting +range.CharacterFormat.Bold = True 'Saves and closes the document document.Save("Sample.docx", FormatType.Docx) document.Close() @@ -395,10 +429,12 @@ document.Close() {% endtabs %} -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-find-next-paragraphs). +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-next). ## Replacing the Search results +### Find and replace text with body part + You can replace a particular text with another text, part of a document or entire document by using [Replace](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_Replace_System_String_Syncfusion_DocIO_DLS_TextBodyPart_System_Boolean_System_Boolean_System_Boolean_) method. The following code example illustrates how to replace a particular text. @@ -454,6 +490,8 @@ document.Close() You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Replace-text-with-body-part). +### Find and replace first occurrence + You can specify to replace only the first occurrence of the specified text by setting [ReplaceFirst](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_ReplaceFirst) property of [WordDocument](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html) class to true. The following code example illustrates how to replace the first occurrence of a particular text. @@ -515,6 +553,8 @@ document.Close() You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-replace-first-occurrence). +### Find and replace text with Word document + The following code example illustrates how to replace a particular text with a Word document. {% tabs %} @@ -563,6 +603,8 @@ document.Close() You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Replace-text-with-Word-document). +### Find and replace paragraphs with text + You can replace a particular text extended to several paragraphs in a document with another text or part of a document by using [ReplaceSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_ReplaceSingleLine_System_String_System_String_System_Boolean_System_Boolean_) method. The following code example illustrates how to replace the text extended to several paragraphs with simple text. @@ -606,7 +648,7 @@ document.Close() You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-replace-paragraphs-with-text). -## Find next and replace with formatted text +### Find next and replace with formatted text You can find the next occurrence of a text using the [FindNext](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindNext_Syncfusion_DocIO_DLS_TextBodyItem_System_Text_RegularExpressions_Regex_) method. You can also replace the text that extends to two paragraphs using [ReplaceSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_ReplaceSingleLine_System_String_Syncfusion_DocIO_DLS_TextSelection_System_Boolean_System_Boolean_) method. The following code example illustrates how to replace the text extended to several paragraphs with a particular text in the document. @@ -666,7 +708,7 @@ End Using You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-next-and-replace-with-formatted-text). -## Find and replace text with other text +### Find and replace text with other text You can find text in a Word document and replace it with other text. Unlike the [Find](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_Find_System_String_System_Boolean_System_Boolean_) method, the Replace method replaces all occurrences of the text. You can customize it to replace only the first occurrence of a text by setting the [ReplaceFirst](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_ReplaceFirst) property of the [WordDocument](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html) class to true. @@ -710,7 +752,7 @@ document.Close() You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Replace-misspelled-word). -## Find and replace non-breaking spaces with regular spaces +### Find and replace non-breaking spaces with regular spaces You can find non-breaking spaces used in a Word document and replace them with regular spaces using [Replace](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_Replace_System_String_System_String_System_Boolean_System_Boolean_) method. The following code example illustrates how to find and replace non-breaking spaces with regular spaces in a Word document. @@ -758,7 +800,7 @@ End Using You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-replace-non-breaking-spaces). -## Find and replace text with an image +### Find and replace text with an image You can find placeholder text in a Word document and replace it with any desired image. The following code example illustrates how to find and replace text in a word document with an image @@ -889,7 +931,7 @@ document.Close(); You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-replace-text-with-image). -## Find and replace a pattern of text with a merge field +### Find and replace a pattern of text with a merge field You can find and replace a pattern of text in a Word document with merge fields using Regex. The following code example illustrates how to create a mail merge template by replacing a pattern of text (enclosed within ‘«’ and ‘»’) in a Word document with the desired merge fields. @@ -977,7 +1019,7 @@ document.Close() You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-replace-with-merge-field). -## Find and replace text with a table +### Find and replace text with a table You can find placeholder text in a Word document and replace it with a table. The following code example illustrates how to do this. @@ -1358,7 +1400,7 @@ End Sub You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-replace-text-with-table). -## Find and replace text in Word document with another document +### Find and replace text in Word document with another document You can find and replace text with another Word document. @@ -1422,10 +1464,12 @@ document.Close() You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-replace-with-Word-document). -## Find and replace text extending to several paragraphs +### Find and replace text extending to several paragraphs Apart from finding text in a paragraph, you can also find and replace text that extends to several paragraphs in a Word document. You can find the first occurrence of the text that extends to several paragraphs by using the [FindSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindSingleLine_System_String_System_Boolean_System_Boolean_) method. Find the next occurrences of the text by using the [FindNextSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindNextSingleLine_Syncfusion_DocIO_DLS_TextBodyItem_System_String_System_Boolean_System_Boolean_) method. Similarly, you can replace text that extends to several paragraphs by using [ReplaceSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_ReplaceSingleLine_System_String_Syncfusion_DocIO_DLS_TextBodyPart_System_Boolean_System_Boolean_) method. +N> The [FindSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindSingleLine_System_String_System_Boolean_System_Boolean_) method matches text across multiple paragraphs but skips intermediate empty paragraphs in the resulting text selection. + The following code example illustrates how to replace text that extends to several paragraphs. {% tabs %} @@ -1491,7 +1535,7 @@ document.Close() You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-replace-multiple-paragraphs). -## Find text in a Word document and format +### Find text in a Word document and format You can find text in a Word document and format or highlight it .You can find the first occurrence of text using the [FindAll](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindAll_System_String_System_Boolean_System_Boolean_) method. Find the next occurrences of the text using the [FindNext](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindNext_Syncfusion_DocIO_DLS_TextBodyItem_System_String_System_Boolean_System_Boolean_) method. @@ -1549,7 +1593,7 @@ document.Close() You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-highlight-all). -## Find and replace the pattern of text with normal text +### Find and replace the pattern of text with normal text You can find the pattern of text using Regex and replace it with normal text in a Word document using the [Replace](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_Replace_System_Text_RegularExpressions_Regex_System_String_) method. @@ -1598,7 +1642,7 @@ End Using You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Replace-pattern-text-with-normal-text). -## Find and replace a pattern of multiline text +### Find and replace a pattern of multiline text You can find a pattern of text which extends to several paragraphs using Regex and replace it with normal text in a Word document using the [ReplaceSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_ReplaceSingleLine_System_Text_RegularExpressions_Regex_System_String_) method. @@ -1647,7 +1691,7 @@ End Using You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Replace-multiline-text-with-single-line). -## Find and replace text with formatted text +### Find and replace text with formatted text You can select a text using the [Find](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_Find_System_Text_RegularExpressions_Regex_) method and replace text in a Word document with that selected text along with formatting (bold, italic, and so on). @@ -1702,7 +1746,7 @@ End Using You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-replace-text-with-formatted-text). -## Find and replace the text extended to several paragraphs +### Find and replace the text extended to several paragraphs You can select a text which extends to several paragraphs using the [FindSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindSingleLine_System_Text_RegularExpressions_Regex_) method and replace text in the Word document with that selected text. @@ -1757,7 +1801,7 @@ End Using You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Replace-text-extended-to-several-paragraphs). -## Find next multiline text and replace with selected text +### Find next multiline text and replace with selected text You can select the next occurrence of a text which extends to several paragraphs using the [FindNextSingleLine](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindNextSingleLine_Syncfusion_DocIO_DLS_TextBodyItem_System_Text_RegularExpressions_Regex_) method and replace text in the Word document with that selected text. @@ -1818,6 +1862,68 @@ End Using You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-next-multiline-text-and-replace-text). +## Find and format text + +You can able to find and format the text in Word document using DocIO. + +### Find and highlight all in Word document + +You can find text in a Word document and format or highlight it .You can find the first occurrence of text using the [FindAll](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindAll_System_String_System_Boolean_System_Boolean_) method. Find the next occurrences of the text using the [FindNext](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_FindNext_Syncfusion_DocIO_DLS_TextBodyItem_System_String_System_Boolean_System_Boolean_) method. + +The following code example illustrates how to find all occurrences of a length of text and highlight it. + +{% tabs %} + +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Find-and-Replace/Find-and-highlight-all/.NET/Find-and-highlight-all/Program.cs" %} +//Loads the template document +FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); +WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); +//Finds all occurrence of the text in the Word document +TextSelection[] textSelections = document.FindAll("Adventure", true, true); +for (int i = 0; i < textSelections.Length; i++) +{ + //Sets the highlight color for the searched text as Yellow + textSelections[i].GetAsOneRange().CharacterFormat.HighlightColor = Color.Yellow; +} +//Saves and closes the document +FileStream outputStream = new FileStream("Sample.docx", FileMode.Create, FileAccess.ReadWrite, FileShare.ReadWrite); +document.Save(outputStream, FormatType.Docx); +document.Close(); +{% endhighlight %} + +{% highlight c# tabtitle="C# [Windows-specific]" %} +//Loads the template document +WordDocument document = new WordDocument("Template.docx"); +//Finds all occurrence of the text in the Word document +TextSelection[] textSelections = document.FindAll("Adventure", true, true); +for (int i = 0; i < textSelections.Length; i++) +{ + //Sets the highlight color for the searched text as Yellow + textSelections[i].GetAsOneRange().CharacterFormat.HighlightColor = Color.Yellow; +} +//Saves and closes the document instance +document.Save("Result.docx"); +document.Close(); +{% endhighlight %} + +{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} +'Loads the template document +Dim document As WordDocument = New WordDocument("Template.docx") +'Finds all occurrence of the text in the Word document +Dim textSelections() As TextSelection = document.FindAll("Adventure", True, True) +For i As Integer = 0 To textSelections.Length - 1 + 'Sets the highlight color for the searched text as Yellow. + textSelections(i).GetAsOneRange.CharacterFormat.HighlightColor = Color.Yellow +Next +'Saves and closes the document instance +document.Save("Result.docx") +document.Close() +{% endhighlight %} + +{% endtabs %} + +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Find-and-Replace/Find-and-highlight-all). + ## Online Demo * Explore how to find a specific text pattern using regular expression and highlight it in an existing Word document using find functionality using the .NET Word Library (DocIO) in a live demo [here](https://ej2.syncfusion.com/aspnetcore/word/findandhighlight#/bootstrap5). @@ -1847,3 +1953,4 @@ You can download a complete working sample from [GitHub](https://github.com/Sync * [How to find and apply bold formatting to a specific word in replaced content](https://support.syncfusion.com/kb/article/17700/how-to-find-and-apply-bold-formatting-to-a-specific-word-in-replaced-content) * [How to find and replace an image title in a Word document?](https://support.syncfusion.com/kb/article/18808/how-to-find-and-replace-an-image-title-in-a-word-document) * [How to apply bold formatting to the content between placeholders in a Word document?](https://support.syncfusion.com/kb/article/17778/how-to-apply-bold-formatting-to-the-content-between-placeholders-in-a-word-document) +* [How to Replace and Convert Word Document to PDF in ASP.NET Core?](https://support.syncfusion.com/kb/article/20112/how-to-replace-and-convert-word-document-to-pdf-in-aspnet-core) diff --git a/Document-Processing/Word/Word-Library/NET/Working-with-Form-Fields.md b/Document-Processing/Word/Word-Library/NET/Working-with-Form-Fields.md index 484b081e4..1108d9af6 100644 --- a/Document-Processing/Word/Word-Library/NET/Working-with-Form-Fields.md +++ b/Document-Processing/Word/Word-Library/NET/Working-with-Form-Fields.md @@ -15,6 +15,7 @@ The following are the types of form field in the Word document * Drop-down – represented by an instance of [WDropDownFormField](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WDropDownFormField.html) * Text input – represented by an instance of [WTextFormField](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WTextFormField.html) +N> To generate editable fields in the PDF converted from a Word document, use Form Fields; regular text and content controls will not be editable. Refer [here](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/word-to-pdf-settings#word-document-form-field-to-pdf-form-field) to learn more about converting form fields as editable fields during Word to PDF conversion. ## Check Box diff --git a/Document-Processing/Word/Word-Library/NET/Working-with-Paragraph.md b/Document-Processing/Word/Word-Library/NET/Working-with-Paragraph.md index dee069ec8..3441d6cde 100644 --- a/Document-Processing/Word/Word-Library/NET/Working-with-Paragraph.md +++ b/Document-Processing/Word/Word-Library/NET/Working-with-Paragraph.md @@ -1175,1049 +1175,7 @@ Lists can organize and format the contents of a document in hierarchical way. Th * Numbered list * Bulleted list -The following code example explains how to create a simple bulleted list. - -{% tabs %} - -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Paragraphs/Simple-bulleted-list/.NET/Simple-bulleted-list/Program.cs" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Applies default numbered list style -paragraph.ListFormat.ApplyDefBulletStyle(); -//Adds text to the paragraph -paragraph.AppendText("List item 1"); -//Continues the list defined -paragraph.ListFormat.ContinueListNumbering(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 2"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 3"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Saves the Word document to MemoryStream. -MemoryStream stream = new MemoryStream(); -document.Save(stream, FormatType.Docx); -//Closes the Word document. -document.Close(); -{% endhighlight %} - -{% highlight c# tabtitle="C# [Windows-specific]" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Applies default numbered list style -paragraph.ListFormat.ApplyDefBulletStyle(); -//Adds text to the paragraph -paragraph.AppendText("List item 1"); -//Continues the list defined -paragraph.ListFormat.ContinueListNumbering(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 2"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 3"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Saves the Word document -document.Save("Sample.docx", FormatType.Docx); -//Closes the document -document.Close(); -{% endhighlight %} - -{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} -'Creates a new Word document -Dim document As New WordDocument() -'Adds new section to the document -Dim section As IWSection = document.AddSection() -'Adds new paragraph to the section -Dim paragraph As IWParagraph = section.AddParagraph() -'Applies default numbered list style -paragraph.ListFormat.ApplyDefBulletStyle() -'Adds text to the paragraph -paragraph.AppendText("List item 1") -'Continues the list defined -paragraph.ListFormat.ContinueListNumbering() -'Adds second paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("List item 2") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Adds new paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("List item 3") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Saves the Word document -document.Save("Sample.docx", FormatType.Docx) -'Closes the document -document.Close() -{% endhighlight %} - -{% endtabs %} - -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/Simple-bulleted-list). - -The following code example explains how to create a simple numbered list. - -{% tabs %} - -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Paragraphs/Simple-numbered-list/.NET/Simple-numbered-list/Program.cs" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Applies default numbered list style -paragraph.ListFormat.ApplyDefNumberedStyle(); -//Adds text to the paragraph -paragraph.AppendText("List item 1"); -//Continues the list defined -paragraph.ListFormat.ContinueListNumbering(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 2"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 3"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Saves the Word document to MemoryStream. -MemoryStream stream = new MemoryStream(); -document.Save(stream, FormatType.Docx); -//Closes the Word document. -document.Close(); -{% endhighlight %} - -{% highlight c# tabtitle="C# [Windows-specific]" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Applies default numbered list style -paragraph.ListFormat.ApplyDefNumberedStyle(); -//Adds text to the paragraph -paragraph.AppendText("List item 1"); -//Continues the list defined -paragraph.ListFormat.ContinueListNumbering(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 2"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 3"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Saves the Word document -document.Save("Sample.docx", FormatType.Docx); -//Closes the document -document.Close(); -{% endhighlight %} - -{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} -'Creates a new Word document -Dim document As New WordDocument() -'Adds new section to the document -Dim section As IWSection = document.AddSection() -'Adds new paragraph to the section -Dim paragraph As IWParagraph = section.AddParagraph() -'Applies default numbered list style -paragraph.ListFormat.ApplyDefNumberedStyle() -'Adds text to the paragraph -paragraph.AppendText("List item 1") -'Continues the list defined -paragraph.ListFormat.ContinueListNumbering() -'Adds second paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("List item 2") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Adds new paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("List item 3") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Saves the Word document -document.Save("Sample.docx", FormatType.Docx) -'Closes the document -document.Close() -{% endhighlight %} - -{% endtabs %} - -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/Simple-numbered-list). - -The following code example explains how to create a multilevel bulleted list. - -{% tabs %} - -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Paragraphs/Multilevel-bulleted-list/.NET/Multilevel-bulleted-list/Program.cs" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Applies default numbered list style -paragraph.ListFormat.ApplyDefBulletStyle(); -//Adds text to the paragraph -paragraph.AppendText("List item 1 - Level 0"); -//Continues the list defined -paragraph.ListFormat.ContinueListNumbering(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 2 - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 3 - Level 2"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document to MemoryStream. -MemoryStream stream = new MemoryStream(); -document.Save(stream, FormatType.Docx); -//Closes the Word document. -document.Close(); -{% endhighlight %} - -{% highlight c# tabtitle="C# [Windows-specific]" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Applies default numbered list style -paragraph.ListFormat.ApplyDefBulletStyle(); -//Adds text to the paragraph -paragraph.AppendText("List item 1 - Level 0"); -//Continues the list defined -paragraph.ListFormat.ContinueListNumbering(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 2 - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 3 - Level 2"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document -document.Save("Sample.docx", FormatType.Docx); -//Closes the document -document.Close(); -{% endhighlight %} - -{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} -'Creates a new Word document -Dim document As New WordDocument() -'Adds new section to the document -Dim section As IWSection = document.AddSection() -'Adds new paragraph to the section -Dim paragraph As IWParagraph = section.AddParagraph() -'Applies default numbered list style -paragraph.ListFormat.ApplyDefBulletStyle() -'Adds text to the paragraph -paragraph.AppendText("List item 1 - Level 0") -'Continues the list defined -paragraph.ListFormat.ContinueListNumbering() -'Adds second paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("List item 2 - Level 1") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel() -'Adds new paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("List item 3 - Level 2") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel() -'Saves the Word document -document.Save("Sample.docx", FormatType.Docx) -'Closes the document -document.Close() -{% endhighlight %} - -{% endtabs %} - -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/Multilevel-bulleted-list). - -The following code example explains how to create multilevel numbered list. - -{% tabs %} - -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Paragraphs/Multilevel-numbered-list/.NET/Multilevel-numbered-list/Program.cs" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Applies default numbered list style -paragraph.ListFormat.ApplyDefNumberedStyle(); -//Adds text to the paragraph -paragraph.AppendText("List item 1 - Level 0"); -//Continues the list defined -paragraph.ListFormat.ContinueListNumbering(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 2 - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 3 - Level 2"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document to MemoryStream. -MemoryStream stream = new MemoryStream(); -document.Save(stream, FormatType.Docx); -//Closes the Word document. -document.Close(); -{% endhighlight %} - -{% highlight c# tabtitle="C# [Windows-specific]" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Applies default numbered list style -paragraph.ListFormat.ApplyDefNumberedStyle(); -//Adds text to the paragraph -paragraph.AppendText("List item 1 - Level 0"); -//Continues the list defined -paragraph.ListFormat.ContinueListNumbering(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 2 - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("List item 3 - Level 2"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document -document.Save("Sample.docx", FormatType.Docx); -//Closes the document -document.Close(); -{% endhighlight %} - -{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} -'Creates a new Word document -Dim document As New WordDocument() -'Adds new section to the document -Dim section As IWSection = document.AddSection() -'Adds new paragraph to the section -Dim paragraph As IWParagraph = section.AddParagraph() -'Applies default numbered list style -paragraph.ListFormat.ApplyDefNumberedStyle() -'Adds text to the paragraph -paragraph.AppendText("List item 1 - Level 0") -'Continues the list defined -paragraph.ListFormat.ContinueListNumbering() -'Adds second paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("List item 2 - Level 1") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel() -'Adds new paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("List item 3 - Level 2") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel() -'Saves the Word document -document.Save("Sample.docx", FormatType.Docx) -'Closes the document -document.Close() -{% endhighlight %} - -{% endtabs %} - -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/Multilevel-numbered-list). - -The list levels can be incremented or decremented by using the [IncreaseIndentLevel](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WListFormat.html#Syncfusion_DocIO_DLS_WListFormat_IncreaseIndentLevel) and [DecreaseIndentLevel](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WListFormat.html#Syncfusion_DocIO_DLS_WListFormat_DecreaseIndentLevel) methods respectively. The following code example explains how to increase or decrease the list indent levels. - -{% tabs %} - -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Paragraphs/Increase-or-decrease-list-indent/.NET/Increase-or-decrease-list-indent/Program.cs" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Applies default numbered list style -paragraph.ListFormat.ApplyDefNumberedStyle(); -//Adds text to the paragraph -paragraph.AppendText("Multilevel numbered list - Level 0"); -//Continues the list defined -paragraph.ListFormat.ContinueListNumbering(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("Multilevel numbered list - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("Multilevel numbered list - Level 0"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.DecreaseIndentLevel(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("Multilevel numbered list - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document to MemoryStream. -MemoryStream stream = new MemoryStream(); -document.Save(stream, FormatType.Docx); -//Closes the Word document. -document.Close(); -{% endhighlight %} - -{% highlight c# tabtitle="C# [Windows-specific]" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Applies default numbered list style -paragraph.ListFormat.ApplyDefNumberedStyle(); -//Adds text to the paragraph -paragraph.AppendText("Multilevel numbered list - Level 0"); -//Continues the list defined -paragraph.ListFormat.ContinueListNumbering(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("Multilevel numbered list - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("Multilevel numbered list - Level 0"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.DecreaseIndentLevel(); -//Adds new paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("Multilevel numbered list - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document -document.Save("Sample.docx", FormatType.Docx); -//Closes the document -document.Close(); -{% endhighlight %} - -{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} -'Creates a new Word document -Dim document As New WordDocument() -'Adds new section to the document -Dim section As IWSection = document.AddSection() -'Adds new paragraph to the section -Dim paragraph As IWParagraph = section.AddParagraph() -'Applies default numbered list style -paragraph.ListFormat.ApplyDefNumberedStyle() -'Adds text to the paragraph -paragraph.AppendText("Multilevel numbered list - Level 0") -'Continues the list defined -paragraph.ListFormat.ContinueListNumbering() -'Adds second paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("Multilevel numbered list - Level 1") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel() -'Adds new paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("Multilevel numbered list - Level 0") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Increases the level indent -paragraph.ListFormat.DecreaseIndentLevel() -'Adds new paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("Multilevel numbered list - Level 1") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel() -'Saves the Word document -document.Save("Sample.docx", FormatType.Docx) -'Closes the document -document.Close() -{% endhighlight %} - -{% endtabs %} - -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/Increase-or-decrease-list-indent). - -The following code example explains how to create user defined list styles. - -{% tabs %} - -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Paragraphs/User-defined-numbered-list/.NET/User-defined-numbered-list/Program.cs" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new list style to the document -ListStyle listStyle = document.AddListStyle(ListType.Numbered, "UserDefinedList"); -WListLevel levelOne = listStyle.Levels[0]; -//Defines the follow character, prefix, suffix, start index for level 0 -levelOne.FollowCharacter = FollowCharacterType.Tab; -levelOne.NumberPrefix = "("; -levelOne.NumberSufix = ")"; -levelOne.PatternType = ListPatternType.LowRoman; -levelOne.StartAt = 1; -levelOne.TabSpaceAfter = 5; -levelOne.NumberAlignment = ListNumberAlignment.Center; -WListLevel levelTwo = listStyle.Levels[1]; -//Defines the follow character, suffix, pattern, start index for level 1 -levelTwo.FollowCharacter = FollowCharacterType.Tab; -levelTwo.NumberSufix = "}"; -levelTwo.PatternType = ListPatternType.LowLetter; -levelTwo.StartAt = 2; -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Adds text to the paragraph -paragraph.AppendText("User defined list - Level 0"); -//Applies default numbered list style -paragraph.ListFormat.ApplyStyle("UserDefinedList"); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("User defined list - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document to MemoryStream. -MemoryStream stream = new MemoryStream(); -document.Save(stream, FormatType.Docx); -//Closes the Word document. -document.Close(); -{% endhighlight %} - -{% highlight c# tabtitle="C# [Windows-specific]" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new list style to the document -ListStyle listStyle = document.AddListStyle(ListType.Numbered, "UserDefinedList"); -WListLevel levelOne = listStyle.Levels[0]; -//Defines the follow character, prefix, suffix, start index for level 0 -levelOne.FollowCharacter = FollowCharacterType.Tab; -levelOne.NumberPrefix = "("; -levelOne.NumberSufix = ")"; -levelOne.PatternType = ListPatternType.LowRoman; -levelOne.StartAt = 1; -levelOne.TabSpaceAfter = 5; -levelOne.NumberAlignment = ListNumberAlignment.Center; -WListLevel levelTwo = listStyle.Levels[1]; -//Defines the follow character, suffix, pattern, start index for level 1 -levelTwo.FollowCharacter = FollowCharacterType.Tab; -levelTwo.NumberSufix = "}"; -levelTwo.PatternType = ListPatternType.LowLetter; -levelTwo.StartAt = 2; -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Adds text to the paragraph -paragraph.AppendText("User defined list - Level 0"); -//Applies default numbered list style -paragraph.ListFormat.ApplyStyle("UserDefinedList"); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("User defined list - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document -document.Save("Sample.docx", FormatType.Docx); -//Closes the document -document.Close(); -{% endhighlight %} - -{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} -'Creates a new Word document -Dim document As New WordDocument() -'Adds new section to the document -Dim section As IWSection = document.AddSection() -'Adds new list style to the document -Dim listStyle As ListStyle = document.AddListStyle(ListType.Numbered, "UserDefinedList") -Dim levelOne As WListLevel = listStyle.Levels(0) -'Defines the follow character, prefix, suffix, start index for level 0 -levelOne.FollowCharacter = FollowCharacterType.Tab -levelOne.NumberPrefix = "(" -levelOne.NumberSufix = ")" -levelOne.PatternType = ListPatternType.LowRoman -levelOne.StartAt = 1 -levelOne.TabSpaceAfter = 5 -levelOne.NumberAlignment = ListNumberAlignment.Center -Dim levelTwo As WListLevel = listStyle.Levels(1) -'Defines the follow character, suffix, pattern, start index for level 1 -levelTwo.FollowCharacter = FollowCharacterType.Tab -levelTwo.NumberSufix = "}" -levelTwo.PatternType = ListPatternType.LowLetter -levelTwo.StartAt = 2 -'Adds new paragraph to the section -Dim paragraph As IWParagraph = section.AddParagraph() -'Adds text to the paragraph -paragraph.AppendText("User defined list - Level 0") -'Applies default numbered list style -paragraph.ListFormat.ApplyStyle("UserDefinedList") -'Adds second paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("User defined list - Level 1") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel() -'Saves the Word document -document.Save("Sample.docx", FormatType.Docx) -'Closes the document -document.Close() -{% endhighlight %} - -{% endtabs %} - -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/User-defined-numbered-list). - -The following code example explains how to create numbered list with prefix from previous level. - -N> The [NumberPrefix](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WListLevel.html#Syncfusion_DocIO_DLS_WListLevel_NumberPrefix) value for the numbered list should meet the syntax "\u000N" to update the previous list level value as prefix to the current list level. For example, it should be represented as (“\u0000.” or “\u0000.\u0001.”). - -{% tabs %} - -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Paragraphs/List-with-prefix-from-previous-level/.NET/List-with-prefix-from-previous-level/Program.cs" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new list style to the document -ListStyle listStyle = document.AddListStyle(ListType.Numbered, "UserDefinedList"); -WListLevel levelOne = listStyle.Levels[0]; -//Defines the follow character, prefix from previous level, start index for level 0 -levelOne.FollowCharacter = FollowCharacterType.Nothing; -levelOne.PatternType = ListPatternType.Arabic; -levelOne.StartAt = 1; -WListLevel levelTwo = listStyle.Levels[1]; -//Defines the follow character, prefix from previous level, pattern, start index for level 1 -levelTwo.FollowCharacter = FollowCharacterType.Nothing; -levelTwo.NumberPrefix = "\u0000."; -levelTwo.PatternType = ListPatternType.Arabic; -levelTwo.StartAt = 1; -WListLevel levelThree = listStyle.Levels[2]; -//Defines the follow character, prefix from previous level, pattern, start index for level 1 -levelThree.FollowCharacter = FollowCharacterType.Nothing; -levelThree.NumberPrefix = "\u0000.\u0001."; -levelThree.PatternType = ListPatternType.Arabic; -levelThree.StartAt = 1; -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Adds text to the paragraph -paragraph.AppendText("User defined list - Level 0"); -//Applies default numbered list style -paragraph.ListFormat.ApplyStyle("UserDefinedList"); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("User defined list - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("User defined list - Level 2"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document to MemoryStream. -MemoryStream stream = new MemoryStream(); -document.Save(stream, FormatType.Docx); -//Closes the Word document. -document.Close(); -{% endhighlight %} - -{% highlight c# tabtitle="C# [Windows-specific]" %} -//Creates a new Word document -WordDocument document = new WordDocument(); -//Adds new section to the document -IWSection section = document.AddSection(); -//Adds new list style to the document -ListStyle listStyle = document.AddListStyle(ListType.Numbered, "UserDefinedList"); -WListLevel levelOne = listStyle.Levels[0]; -//Defines the follow character, prefix from previous level, start index for level 0 -levelOne.FollowCharacter = FollowCharacterType.Nothing; -levelOne.PatternType = ListPatternType.Arabic; -levelOne.StartAt = 1; -WListLevel levelTwo = listStyle.Levels[1]; -//Defines the follow character, prefix from previous level, pattern, start index for level 1 -levelTwo.FollowCharacter = FollowCharacterType.Nothing; -levelTwo.NumberPrefix = "\u0000."; -levelTwo.PatternType = ListPatternType.Arabic; -levelTwo.StartAt = 1; -WListLevel levelThree = listStyle.Levels[2]; -//Defines the follow character, prefix from previous level, pattern, start index for level 1 -levelThree.FollowCharacter = FollowCharacterType.Nothing; -levelThree.NumberPrefix = "\u0000.\u0001."; -levelThree.PatternType = ListPatternType.Arabic; -levelThree.StartAt = 1; -//Adds new paragraph to the section -IWParagraph paragraph = section.AddParagraph(); -//Adds text to the paragraph -paragraph.AppendText("User defined list - Level 0"); -//Applies default numbered list style -paragraph.ListFormat.ApplyStyle("UserDefinedList"); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("User defined list - Level 1"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Adds second paragraph -paragraph = section.AddParagraph(); -paragraph.AppendText("User defined list - Level 2"); -//Continues last defined list -paragraph.ListFormat.ContinueListNumbering(); -//Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document -document.Save("Sample.docx", FormatType.Docx); -//Closes the document -document.Close(); -{% endhighlight %} - -{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} -'Creates a new Word document -Dim document As New WordDocument() -'Adds new section to the document -Dim section As IWSection = document.AddSection() -'Adds new list style to the document -Dim listStyle As ListStyle = document.AddListStyle(ListType.Numbered, "UserDefinedList") -Dim levelOne As WListLevel = listStyle.Levels(0) -'Defines the follow character, prefix from previous level, start index for level 0 -levelOne.FollowCharacter = FollowCharacterType.[Nothing] -levelOne.PatternType = ListPatternType.Arabic -levelOne.StartAt = 1 -Dim levelTwo As WListLevel = listStyle.Levels(1) -'Defines the follow character, prefix from previous level, pattern, start index for level 1 -levelTwo.FollowCharacter = FollowCharacterType.[Nothing] -levelTwo.NumberPrefix = vbNullChar & "." -levelTwo.PatternType = ListPatternType.Arabic -levelTwo.StartAt = 1 -Dim levelThree As WListLevel = listStyle.Levels(2) -'Defines the follow character, prefix from previous level, pattern, start index for level 1 -levelThree.FollowCharacter = FollowCharacterType.[Nothing] -levelThree.NumberPrefix = vbNullChar & "." & ChrW(1) & "." -levelThree.PatternType = ListPatternType.Arabic -levelThree.StartAt = 1 -'Adds new paragraph to the section -Dim paragraph As IWParagraph = section.AddParagraph() -'Adds text to the paragraph -paragraph.AppendText("User defined list - Level 0") -'Applies default numbered list style -paragraph.ListFormat.ApplyStyle("UserDefinedList") -'Adds second paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("User defined list - Level 1") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel() -'Adds second paragraph -paragraph = section.AddParagraph() -paragraph.AppendText("User defined list - Level 2") -'Continues last defined list -paragraph.ListFormat.ContinueListNumbering() -'Increases the level indent -paragraph.ListFormat.IncreaseIndentLevel() -'Saves the Word document -document.Save("Sample.docx", FormatType.Docx) -'Closes the document -document.Close() -{% endhighlight %} - -{% endtabs %} - -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/List-with-prefix-from-previous-level). - -The following code example illustrates how to create a user defined bulleted list style. - -{% tabs %} - -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Paragraphs/User-defined-bulleted-list/.NET/User-defined-bulleted-list/Program.cs" %} -//Create a new Word document. -WordDocument document = new WordDocument(); -//Add a new section to the document. -IWSection section = document.AddSection(); -//Add a new list style to the document. -ListStyle listStyle = document.AddListStyle(ListType.Bulleted, "UserDefinedList"); -WListLevel levelOne = listStyle.Levels[0]; -//Define the following character, pattern and start index for level 0. -levelOne.PatternType = ListPatternType.Bullet; -levelOne.BulletCharacter = "*"; -levelOne.StartAt = 1; -WListLevel levelTwo = listStyle.Levels[1]; -//Define the following character, pattern and start index for level 1. -levelTwo.PatternType = ListPatternType.Bullet; -levelTwo.BulletCharacter = "\u00A9"; -levelTwo.CharacterFormat.FontName = "Wingdings"; -levelTwo.StartAt = 1; -WListLevel levelThree = listStyle.Levels[2]; -//Define the following character, pattern and start index for level 2. -levelThree.PatternType = ListPatternType.Bullet; -levelThree.BulletCharacter = "\u0076"; -levelThree.CharacterFormat.FontName = "Wingdings"; -levelThree.StartAt = 1; -//Add a new paragraph to the section. -IWParagraph paragraph = section.AddParagraph(); -//Add a text to the paragraph. -paragraph.AppendText("User defined list - Level 0"); -//Apply the default bulleted list style. -paragraph.ListFormat.ApplyStyle("UserDefinedList"); -//Add second paragraph. -paragraph = section.AddParagraph(); -paragraph.AppendText("User defined list - Level 1"); -//Continue the last defined list. -paragraph.ListFormat.ContinueListNumbering(); -//Increase the level indent. -paragraph.ListFormat.IncreaseIndentLevel(); -//Add second paragraph. -paragraph = section.AddParagraph(); -paragraph.AppendText("User defined list - Level 2"); -//Continue the last defined list. -paragraph.ListFormat.ContinueListNumbering(); -//Increase the level indent. -paragraph.ListFormat.IncreaseIndentLevel(); -//Saves the Word document to MemoryStream. -MemoryStream stream = new MemoryStream(); -document.Save(stream, FormatType.Docx); -//Closes the Word document. -document.Close(); -{% endhighlight %} - -{% highlight c# tabtitle="C# [Windows-specific]" %} -//Create a new Word document. -WordDocument document = new WordDocument(); -//Add a new section to the document. -IWSection section = document.AddSection(); -//Add a new list style to the document. -ListStyle listStyle = document.AddListStyle(ListType.Bulleted, "UserDefinedList"); -WListLevel levelOne = listStyle.Levels[0]; -//Define the following character, pattern and start index for level 0. -levelOne.PatternType = ListPatternType.Bullet; -levelOne.BulletCharacter = "*"; -levelOne.StartAt = 1; -WListLevel levelTwo = listStyle.Levels[1]; -//Define the following character, pattern and start index for level 1. -levelTwo.PatternType = ListPatternType.Bullet; -levelTwo.BulletCharacter = "\u00A9"; -levelTwo.CharacterFormat.FontName = "Wingdings"; -levelTwo.StartAt = 1; -WListLevel levelThree = listStyle.Levels[2]; -//Define the following character, pattern and start index for level 2. -levelThree.PatternType = ListPatternType.Bullet; -levelThree.BulletCharacter = "\u0076"; -levelThree.CharacterFormat.FontName = "Wingdings"; -levelThree.StartAt = 1; -//Add a new paragraph to the section. -IWParagraph paragraph = section.AddParagraph(); -//Add a text to the paragraph. -paragraph.AppendText("User defined list - Level 0"); -//Apply the default bulleted list style. -paragraph.ListFormat.ApplyStyle("UserDefinedList"); -//Add second paragraph. -paragraph = section.AddParagraph(); -paragraph.AppendText("User defined list - Level 1"); -//Continue the last defined list. -paragraph.ListFormat.ContinueListNumbering(); -//Increase the level indent. -paragraph.ListFormat.IncreaseIndentLevel(); -//Add second paragraph. -paragraph = section.AddParagraph(); -paragraph.AppendText("User defined list - Level 2"); -//Continue the last defined list. -paragraph.ListFormat.ContinueListNumbering(); -//Increase the level indent. -paragraph.ListFormat.IncreaseIndentLevel(); -//Save the Word document. -document.Save("Sample.docx", FormatType.Docx); -//Close the document. -document.Close(); -{% endhighlight %} - -{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} -'Create a new Word document. -Dim document As New WordDocument() -'Add a new section to the document. -Dim section As IWSection = document.AddSection() -'Add a new list style to the document. -Dim listStyle As ListStyle = document.AddListStyle(ListType.Bulleted, "UserDefinedList") -Dim levelOne As WListLevel = listStyle.Levels(0) -'Define the following character, pattern and start index for level 0. -levelOne.PatternType = ListPatternType.Bullet -levelOne.BulletCharacter = "*" -levelOne.StartAt = 1 -Dim levelTwo As WListLevel = listStyle.Levels(1) -'Define the following character, pattern and start index for level 1. -levelTwo.PatternType = ListPatternType.Bullet -levelTwo.BulletCharacter = ChrW(169) -levelTwo.CharacterFormat.FontName = "Wingdings" -levelTwo.StartAt = 1 -Dim levelThree As WListLevel = listStyle.Levels(2) -'Define the following character, pattern and start index for level 2. -levelThree.PatternType = ListPatternType.Bullet -levelThree.BulletCharacter = ChrW(118) -levelThree.CharacterFormat.FontName = "Wingdings" -levelThree.StartAt = 1 -'Add a new paragraph to the section. -Dim paragraph As IWParagraph = section.AddParagraph() -'Add a text to the paragraph. -paragraph.AppendText("User defined list - Level 0") -'Apply the default bulleted list style. -paragraph.ListFormat.ApplyStyle("UserDefinedList") -'Add second paragraph. -paragraph = section.AddParagraph() -paragraph.AppendText("User defined list - Level 1") -'Continue the last defined list. -paragraph.ListFormat.ContinueListNumbering() -'Increase the level indent. -paragraph.ListFormat.IncreaseIndentLevel() -'Add second paragraph. -paragraph = section.AddParagraph() -paragraph.AppendText("User defined list - Level 2") -'Continue the last defined list. -paragraph.ListFormat.ContinueListNumbering() -'Increase the level indent. -paragraph.ListFormat.IncreaseIndentLevel() -'Save the Word document. -document.Save("Sample.docx", FormatType.Docx) -'Close the document. -document.Close() -{% endhighlight %} - -{% endtabs %} - -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/User-defined-bulleted-list). - -### Get list value - -You can get the string that represents the appearance of **list value of the paragraph** in the Word document using the [ListString](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WParagraph.html#Syncfusion_DocIO_DLS_WParagraph_ListString) API. - -This API holds the static string of the list value recently calculated while saving the document as Text. It is not updated automatically for each modification done in the Word document. Hence, you should either invoke the [GetText()](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html#Syncfusion_DocIO_DLS_WordDocument_GetText) method of [WordDocument](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WordDocument.html) or save the Word document as Text to get the actual list value from this API. - -The following example shows how to **get a string that represents the appearance of list value of the paragraph**. - -{% tabs %} - -{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Paragraphs/Get-list-value/.NET/Get-list-value/Program.cs" %} -//Loads an existing Word document -FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); -WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); -//Gets the document text -document.GetText(); -//Gets the string that represents the appearance of list value of the paragraph -String listString = document.LastParagraph.ListString; -//Saves the Word document to MemoryStream. -MemoryStream stream = new MemoryStream(); -document.Save(stream, FormatType.Docx); -//Closes the Word document. -document.Close(); -{% endhighlight %} - -{% highlight c# tabtitle="C# [Windows-specific]" %} -//Loads an existing Word document -WordDocument document = new WordDocument("Template.docx"); -//Gets the document text -document.GetText(); -//Gets the string that represents the appearance of list value of the paragraph -String listString = document.LastParagraph.ListString; -//Saves and closes the WordDocument instance -document.Save("Sample.docx", FormatType.Docx); -document.Close(); -{% endhighlight %} - -{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} -'Loads an existing Word document -Dim document As WordDocument = New WordDocument("Template.docx") -' Gets the document text -document.GetText() -'Gets the string that represents the appearance of list value of the paragraph -Dim listString As String = document.LastParagraph.ListString -'Saves and closes the WordDocument instance -document.Save("Sample.docx", FormatType.Docx) -document.Close() -{% endhighlight %} - -{% endtabs %} - -You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/Get-list-value). - -N> For a picture bulleted list, the [ListString](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WParagraph.html#Syncfusion_DocIO_DLS_WParagraph_ListString) API is not valid and it will return an empty string. +For further information, click [here](https://help.syncfusion.com/document-processing/word/word-library/net/working-with-lists). ## Working with hyperlinks @@ -2817,6 +1775,8 @@ You can download a complete working sample from [GitHub](https://github.com/Sync * [How to restart numbering when replacing multiple texts with the same HTML list in Word document?](https://support.syncfusion.com/kb/article/19665/how-to-restart-numbering-when-replacing-multiple-texts-with-the-same-html-list-in-word-document) * [How to create a list with a hanging indent in a Word document?](https://support.syncfusion.com/kb/article/19649/how-to-create-a-list-with-a-hanging-indent-in-a-word-document) * [How to Keep Paragraphs Inside a Table in ASP.NET Core Word?](https://support.syncfusion.com/kb/article/19678/how-to-keep-paragraphs-inside-a-table-in-aspnet-core-word) +* [How to apply highlight color to fields in a Word document?](https://support.syncfusion.com/kb/article/20092/how-to-apply-highlight-color-to-fields-in-a-word-document) +* [How to Replace DISPLAYBARCODE Field with Image in DocIO .NET Core?](https://support.syncfusion.com/kb/article/19842/how-to-replace-displaybarcode-field-with-image-in-docio-net-core) ## Frequently Asked Questions diff --git a/Document-Processing/Word/Word-Library/NET/Working-with-Sections.md b/Document-Processing/Word/Word-Library/NET/Working-with-Sections.md index 9cb2df33e..8380abb4e 100644 --- a/Document-Processing/Word/Word-Library/NET/Working-with-Sections.md +++ b/Document-Processing/Word/Word-Library/NET/Working-with-Sections.md @@ -1544,6 +1544,7 @@ N> * And also, it is not feasible to get the page-wise details from Word documen * [How to apply background color to footer and add logo in header in a Word document?](https://support.syncfusion.com/kb/article/19582/how-to-apply-background-color-to-footer-and-add-logo-in-header-in-a-word-document) * [How to merge Word documents while keeping the same headers and footers?](https://support.syncfusion.com/kb/article/19454/how-to-merge-word-documents-while-keeping-the-same-headers-and-footers) * [How to copy the header and footer from one template Word document to another Word document?](https://support.syncfusion.com/kb/article/19727/how-to-copy-the-header-and-footer-from-one-template-word-document-to-another-word-document) +* [How to add bookmarks in the header and footer sections of a Word document?](https://support.syncfusion.com/kb/article/20101/how-to-add-bookmarks-in-the-header-and-footer-sections-of-a-word-document) ## Frequently Asked Questions diff --git a/Document-Processing/Word/Word-Library/NET/Working-with-Security.md b/Document-Processing/Word/Word-Library/NET/Working-with-Security.md index 8a71aa299..689d2f491 100644 --- a/Document-Processing/Word/Word-Library/NET/Working-with-Security.md +++ b/Document-Processing/Word/Word-Library/NET/Working-with-Security.md @@ -276,6 +276,653 @@ document.Close() You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Security/Allow-editing-form-fields-only). +## Editable ranges + +An **editable range** is a portion of a Word document that allows editing even when the document is protected. In the Syncfusion .NET Word library (DocIO), editable ranges are represented using the **EditableRange** class. You can define these ranges programmatically to allow user edits within protected documents. + +### Add an editable range + +You can add an editable range in the Word document by using **AppendEditableRangeStart** and **AppendEditableRangeEnd** methods of [WParagraph](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.WParagraph.html) class. + +The following code example illustrates how to add an editable range in the Word document. + +N> 1. DocIO supports editable ranges in DOCX format documents only. +N> 2. Refer to the appropriate tabs in the code snippets section: **C# [Cross-platform]** for ASP.NET Core, Blazor, Xamarin, UWP, .NET MAUI, and WinUI; **C# [Windows-specific]** for WinForms and WPF; **VB.NET [Windows-specific]** for VB.NET applications. + +{% tabs %} + +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Security/Add-editable-range/.NET/Add-editable-range/Program.cs" %} +//Create a Word document +using (WordDocument document = new WordDocument()) +{ + //Add a section and a paragraph to the Word document + document.EnsureMinimal(); + WParagraph paragraph = document.LastParagraph; + + //Append text to the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks "); + + //Add an editable range to the paragraph + EditableRangeStart editableRangeStart = paragraph.AppendEditableRangeStart(); + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company."); + paragraph.AppendEditableRangeEnd(editableRangeStart); + + //Set protection with a password to allow read-only access + document.Protect(ProtectionType.AllowOnlyReading, "password"); + + //Save the Word document to a MemoryStream + MemoryStream stream = new MemoryStream(); + document.Save(stream, FormatType.Docx); +} +{% endhighlight %} + +{% highlight c# tabtitle="C# [Windows-specific]" %} +//Create a Word document +using (WordDocument document = new WordDocument()) +{ + //Add a section and a paragraph to the Word document + document.EnsureMinimal(); + WParagraph paragraph = document.LastParagraph; + + //Append text to the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks "); + + //Add an editable range to the paragraph + EditableRangeStart editableRangeStart = paragraph.AppendEditableRangeStart(); + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company."); + paragraph.AppendEditableRangeEnd(editableRangeStart); + + //Set protection with a password to allow read-only access + document.Protect(ProtectionType.AllowOnlyReading, "password"); + + //Save the Word document + document.Save("EditableRange.docx", FormatType.Docx); +} +{% endhighlight %} + +{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} +'Creates a Word document +Using document As WordDocument = New WordDocument() + 'Adds a section and a paragraph in the document + document.EnsureMinimal() + Dim paragraph As WParagraph = document.LastParagraph + + 'Append text into the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks ") + + 'Adds an editable range to the paragraph + Dim editableRangeStart As EditableRangeStart = paragraph.AppendEditableRangeStart() + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company.") + paragraph.AppendEditableRangeEnd(editableRangeStart) + + 'Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password") + + 'Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx) +End Using +{% endhighlight %} + +{% endtabs %} + +By running the above code, you will generate a **Editable range** as shown below. + + +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Security/Add-editable-range). + +### Retrieve Id of an editable range + +You can retrieve the ID of an editable range using the **Id** property of the **EditableRange** class. + +The following code example illustrates how to retrieve the ID of an editable range from a Word document. + +{% tabs %} + +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Security/Retrieve-editable-range-id/.NET/Retrieve-editable-range-id/Program.cs" %} +//Creates a Word document +using (WordDocument document = new WordDocument()) +{ + //Adds a section and a paragraph in the Word document + document.EnsureMinimal(); + WParagraph paragraph = document.LastParagraph; + + //Append text into the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks "); + + //Adds an editable range to the paragraph + EditableRangeStart editableRangeStart = paragraph.AppendEditableRangeStart(); + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company."); + paragraph.AppendEditableRangeEnd(editableRangeStart); + + //Retrieve the editable range Id + string editableRangeId = editableRangeStart.Id; + + //Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password"); + + //Saves the Word document to MemoryStream + MemoryStream stream = new MemoryStream(); + document.Save(stream, FormatType.Docx); +} +{% endhighlight %} + +{% highlight c# tabtitle="C# [Windows-specific]" %} +//Creates a Word document +using (WordDocument document = new WordDocument()) +{ + //Adds a section and a paragraph in the Word document + document.EnsureMinimal(); + WParagraph paragraph = document.LastParagraph; + + //Append text into the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks "); + + //Adds an editable range to the paragraph + EditableRangeStart editableRangeStart = paragraph.AppendEditableRangeStart(); + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company."); + paragraph.AppendEditableRangeEnd(editableRangeStart); + + //Retrieve the editable range Id + string editableRangeId = editableRangeStart.Id; + + //Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password"); + + //Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx); +} +{% endhighlight %} + +{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} +'Creates a Word document +Using document As WordDocument = New WordDocument() + 'Adds a section and a paragraph in the document + document.EnsureMinimal() + Dim paragraph As WParagraph = document.LastParagraph + + 'Append text into the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks ") + + 'Adds an editable range to the paragraph + Dim editableRangeStart As EditableRangeStart = paragraph.AppendEditableRangeStart() + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company.") + paragraph.AppendEditableRangeEnd(editableRangeStart) + + 'Retrieve the editable range Id + Dim editableRangeId As String = editableRangeStart.Id + + 'Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password") + + 'Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx) +End Using +{% endhighlight %} + +{% endtabs %} + +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Security/Retrieve-editable-range-id). + +### Find an editable range + +You can find an editable range of specific id in the collection of editable ranges through **FindById** method of **EditableRangeCollection** class. + +The following code example illustrates how to find the editable range in a Word document. + +{% tabs %} + +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Security/Find-editable-range-by-id/.NET/Find-editable-range-by-id/Program.cs" %} +//Loads an existing Word document +using (FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite)) +{ + using (WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx)) + { + //Get the editable range by Id + EditableRange editableRange = document.EditableRanges.FindById("0"); + + //Saves the Word document to MemoryStream + MemoryStream stream = new MemoryStream(); + document.Save(stream, FormatType.Docx); + } +} +{% endhighlight %} + +{% highlight c# tabtitle="C# [Windows-specific]" %} +//Loads an existing Word document +using (WordDocument document = new WordDocument("Template.docx")) +{ + //Get the editable range by Id + EditableRange editableRange = document.EditableRanges.FindById("0"); + + //Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx); +} +{% endhighlight %} + +{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} +'Loads an existing Word document +Using document As WordDocument = New WordDocument("Template.docx") + + 'Get the editable range by Id + Dim editableRange As EditableRange = document.EditableRanges.FindById("0") + + 'Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx) +End Using +{% endhighlight %} + +{% endtabs %} + +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Security/Find-editable-range-by-id). + +### Remove an editable range + +You can remove an editable range using the **Remove** method of the **EditableRangeCollection** class. + +The following code example demonstrates how to remove an editable range from a Word document. + +{% tabs %} + +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Security/Remove-editable-range/.NET/Remove-editable-range/Program.cs" %} +//Loads an existing Word document +using (FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite)) +{ + using (WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx)) + { + //Get the editable range by Id + EditableRange editableRange = document.EditableRanges.FindById("0"); + + //Remove the editable range + document.EditableRanges.Remove(editableRange); + + //Saves the Word document to MemoryStream + MemoryStream stream = new MemoryStream(); + document.Save(stream, FormatType.Docx); + } +} +{% endhighlight %} + +{% highlight c# tabtitle="C# [Windows-specific]" %} +//Loads an existing Word document +using (WordDocument document = new WordDocument("Template.docx")) +{ + //Get the editable range by Id + EditableRange editableRange = document.EditableRanges.FindById("0"); + + //Remove the editable range + document.EditableRanges.Remove(editableRange); + + //Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx); +} +{% endhighlight %} + +{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} +'Loads an existing Word document +Using document As WordDocument = New WordDocument("Template.docx") + + 'Get the editable range by Id + Dim editableRange As EditableRange = document.EditableRanges.FindById("0") + + 'Remove the editable range + document.EditableRanges.Remove(editableRange) + + 'Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx) +End Using +{% endhighlight %} + +{% endtabs %} + +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Security/Remove-editable-range). + +An editable range at a specific index can also be removed from the **EditableRangeCollection** using the **RemoveAt** method. + +The following code example demonstrates how to remove an editable range at particular index from a Word document. + +{% tabs %} + +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Security/Remove-editable-range-at-an-index/.NET/Remove-editable-range-at-an-index/Program.cs" %} +//Loads an existing Word document +using (FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite)) +{ + using (WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx)) + { + //Remove the editable range at a particular index + document.EditableRanges.RemoveAt(1); + + //Saves the Word document to MemoryStream + MemoryStream stream = new MemoryStream(); + document.Save(stream, FormatType.Docx); + } +} +{% endhighlight %} + +{% highlight c# tabtitle="C# [Windows-specific]" %} +//Loads an existing Word document +using (WordDocument document = new WordDocument("Template.docx")) +{ + //Remove the editable range at a particular index + document.EditableRanges.RemoveAt(1); + + //Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx); +} +{% endhighlight %} + +{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} +'Loads an existing Word document +Using document As WordDocument = New WordDocument("Template.docx") + + 'Remove the editable range at a particular index + document.EditableRanges.RemoveAt(1) + + 'Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx) +End Using +{% endhighlight %} + +{% endtabs %} + +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Security/Remove-editable-range-at-an-index). + +### Editing permission +You can restrict editable ranges to specific groups or individuals. + +#### Group permission + +You can make an editable range editable by a group using the **EditorGroup** property of the **EditableRange** class. + +The following code example illustrates how to make an editable range available to a group in a Word document. + +{% tabs %} + +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Security/Group-permission-for-editable-range/.NET/Group-permission-for-editable-range/Program.cs" %} +//Creates a Word document +using (WordDocument document = new WordDocument()) +{ + //Adds a section and a paragraph in the Word document + document.EnsureMinimal(); + WParagraph paragraph = document.LastParagraph; + + //Append text into the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks "); + + //Adds an editable range to the paragraph + EditableRangeStart editableRangeStart = paragraph.AppendEditableRangeStart(); + + //Set the editor group + editableRangeStart.EditorGroup = EditorType.Everyone; + + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company."); + paragraph.AppendEditableRangeEnd(editableRangeStart); + + //Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password"); + + //Saves the Word document to MemoryStream + MemoryStream stream = new MemoryStream(); + document.Save(stream, FormatType.Docx); +} +{% endhighlight %} + +{% highlight c# tabtitle="C# [Windows-specific]" %} +//Creates a Word document +using (WordDocument document = new WordDocument()) +{ + //Adds a section and a paragraph in the Word document + document.EnsureMinimal(); + WParagraph paragraph = document.LastParagraph; + + //Append text into the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks "); + + //Adds an editable range to the paragraph + EditableRangeStart editableRangeStart = paragraph.AppendEditableRangeStart(); + + //Set the editor group + editableRangeStart.EditorGroup = EditorType.Everyone; + + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company."); + paragraph.AppendEditableRangeEnd(editableRangeStart); + + //Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password"); + + //Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx); +} +{% endhighlight %} + +{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} +'Creates a Word document +Using document As WordDocument = New WordDocument() + 'Adds a section and a paragraph in the document + document.EnsureMinimal() + Dim paragraph As WParagraph = document.LastParagraph + + 'Append text into the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks ") + + 'Adds an editable range to the paragraph + Dim editableRangeStart As EditableRangeStart = paragraph.AppendEditableRangeStart() + + 'Set the editor group + editableRangeStart.EditorGroup = EditorType.Everyone + + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company.") + paragraph.AppendEditableRangeEnd(editableRangeStart) + + 'Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password") + + 'Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx) +End Using +{% endhighlight %} + +{% endtabs %} + +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Security/Group-permission-for-editable-range). + +#### Single user permission + +Use the **SingleUser** property of the **EditableRange** class to make an editable range available to a single user for editing. + +The following code example illustrates how to make an editable range available to a single user in a Word document. + +{% tabs %} + +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Security/Single-user-permission-for-editable-range/.NET/Single-user-permission-for-editable-range/Program.cs" %} +//Creates a Word document +using (WordDocument document = new WordDocument()) +{ + //Adds a section and a paragraph in the Word document + document.EnsureMinimal(); + WParagraph paragraph = document.LastParagraph; + + //Append text into the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks "); + + //Adds an editable range to the paragraph + EditableRangeStart editableRangeStart = paragraph.AppendEditableRangeStart(); + + //Set the single user + editableRangeStart.SingleUser = "user@domain.com"; + + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company."); + paragraph.AppendEditableRangeEnd(editableRangeStart); + + //Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password"); + + //Saves the Word document to MemoryStream + MemoryStream stream = new MemoryStream(); + document.Save(stream, FormatType.Docx); +} +{% endhighlight %} + +{% highlight c# tabtitle="C# [Windows-specific]" %} +//Creates a Word document +using (WordDocument document = new WordDocument()) +{ + //Adds a section and a paragraph in the Word document + document.EnsureMinimal(); + WParagraph paragraph = document.LastParagraph; + + //Append text into the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks "); + + //Adds an editable range to the paragraph + EditableRangeStart editableRangeStart = paragraph.AppendEditableRangeStart(); + + //Set the single user + editableRangeStart.SingleUser = "user@domain.com"; + + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company."); + paragraph.AppendEditableRangeEnd(editableRangeStart); + + //Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password"); + + //Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx); +} +{% endhighlight %} + +{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} +'Creates a Word document +Using document As WordDocument = New WordDocument() + 'Adds a section and a paragraph in the document + document.EnsureMinimal() + Dim paragraph As WParagraph = document.LastParagraph + + 'Append text into the paragraph + paragraph.AppendText("Adventure Works Cycles, the fictitious company on which the AdventureWorks ") + + 'Adds an editable range to the paragraph + Dim editableRangeStart As EditableRangeStart = paragraph.AppendEditableRangeStart() + + 'Set the single user + editableRangeStart.SingleUser = "user@domain.com" + + paragraph.AppendText("sample databases are based, is a large, multinational manufacturing company.") + paragraph.AppendEditableRangeEnd(editableRangeStart) + + 'Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password") + + 'Saves the Word document + document.Save("EditableRange.docx", FormatType.Docx) +End Using +{% endhighlight %} + +{% endtabs %} + +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Security/Single-user-permission-for-editable-range). + +### Add editable range in a table + +Using the **FirstColumn** and **LastColumn** properties of the **EditableRange** class, you can specify the starting and ending columns of an editable range within a table. + +The following code example illustrates how to add an editable range inside a table in a Word document. + +{% tabs %} + +{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="https://raw.githubusercontent.com/SyncfusionExamples/DocIO-Examples/main/Security/Add-editable-range-in-a-table/.NET/Add-editable-range-in-a-table/Program.cs" %} +//Loads an existing Word document. +using (WordDocument document = new WordDocument(Path.GetFullPath(@"Data/Template.docx"))) +{ + // Access the first table in the first section of the document + WTable table = document.Sections[0].Tables[0] as WTable; + // Access the paragraph in the third row and third column of the table + WParagraph paragraph = table[2, 2].ChildEntities[0] as WParagraph; + // Create a new editable range start for the table cell paragraph + EditableRangeStart editableRangeStart = new EditableRangeStart(document); + // Insert the editable range start at the beginning of the paragraph + paragraph.ChildEntities.Insert(0, editableRangeStart); + // Set the editor group for the editable range to allow everyone to edit + editableRangeStart.EditorGroup = EditorType.Everyone; + // Apply editable range to second column only + editableRangeStart.FirstColumn = 1; + editableRangeStart.LastColumn = 1; + // Access the paragraph + paragraph = table[5, 2].ChildEntities[0] as WParagraph; + // Append an editable range end to close the editable region + paragraph.AppendEditableRangeEnd(); + //Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password"); + //Saves the Word document to MemoryStream + MemoryStream stream = new MemoryStream(); + document.Save(stream, FormatType.Docx); +} +{% endhighlight %} + +{% highlight c# tabtitle="C# [Windows-specific]" %} +//Loads an existing Word document. +using (WordDocument document = new WordDocument(Path.GetFullPath(@"Data/Template.docx"))) +{ + // Access the first table in the first section of the document + WTable table = document.Sections[0].Tables[0] as WTable; + // Access the paragraph in the third row and third column of the table + WParagraph paragraph = table[2, 2].ChildEntities[0] as WParagraph; + // Create a new editable range start for the table cell paragraph + EditableRangeStart editableRangeStart = new EditableRangeStart(document); + // Insert the editable range start at the beginning of the paragraph + paragraph.ChildEntities.Insert(0, editableRangeStart); + // Set the editor group for the editable range to allow everyone to edit + editableRangeStart.EditorGroup = EditorType.Everyone; + // Apply editable range to second column only + editableRangeStart.FirstColumn = 1; + editableRangeStart.LastColumn = 1; + // Access the paragraph + paragraph = table[5, 2].ChildEntities[0] as WParagraph; + // Append an editable range end to close the editable region + paragraph.AppendEditableRangeEnd(); + //Sets the protection with password and allows only reading + document.Protect(ProtectionType.AllowOnlyReading, "password"); + //Saves the Word document + document.Save("Result.docx", FormatType.Docx); +} +{% endhighlight %} + +{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} +' Load an existing Word document. +Using document As New WordDocument(Path.GetFullPath("Data\Template.docx")) + ' Access the first table in the first section of the document. + Dim table As WTable = TryCast(document.Sections(0).Tables(0), WTable) + ' Access the paragraph in the third row and third column of the table. + Dim paragraph As WParagraph = TryCast(table(2, 2).ChildEntities(0), WParagraph) + ' Create a new editable range start for the table cell paragraph. + Dim editableRangeStart As New EditableRangeStart(document) + ' Insert the editable range start at the beginning of the paragraph. + paragraph.ChildEntities.Insert(0, editableRangeStart) + ' Set the editor group for the editable range to allow everyone to edit. + editableRangeStart.EditorGroup = EditorType.Everyone + ' Apply editable range to the second column only. + editableRangeStart.FirstColumn = 1 + editableRangeStart.LastColumn = 1 + ' Access the paragraph. + paragraph = TryCast(table(5, 2).ChildEntities(0), WParagraph) + ' Append an editable range end to close the editable region. + paragraph.AppendEditableRangeEnd() + ' Set the protection with password and allow only reading. + document.Protect(ProtectionType.AllowOnlyReading, "password") + ' Save the Word document. + document.Save("Result.docx", FormatType.Docx) +End Using +{% endhighlight %} + +{% endtabs %} + +By running the above code, you will generate a **Editable range** as shown below. + + +You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Security/Add-editable-range-in-a-table). + +N> 1. Editable ranges are supported only in DOCX format. +N> 2. The **SingleUser** and **EditorGroup** properties cannot be set simultaneously for the same editable range. Setting one will clear the other. + ## Online Demo * Explore how to encrypt and decrypt the Word document using the .NET Word Library (DocIO) in a live demo [here](https://ej2.syncfusion.com/aspnetcore/word/encryptanddecrypt#/bootstrap5). diff --git a/Document-Processing/Word/Word-Library/NET/Working-with-Tables.md b/Document-Processing/Word/Word-Library/NET/Working-with-Tables.md index 521daf403..83aa81fd9 100644 --- a/Document-Processing/Word/Word-Library/NET/Working-with-Tables.md +++ b/Document-Processing/Word/Word-Library/NET/Working-with-Tables.md @@ -2162,6 +2162,8 @@ You can download a complete working sample from [GitHub](https://github.com/Sync * [How to Find and Remove a Table by Title in .Net Core Word document?](https://support.syncfusion.com/kb/article/19677/how-to-find-and-remove-a-table-by-title-in-a-word-document) * [How to adjust the first column to fill remaining space in a Word table?](https://support.syncfusion.com/kb/article/19652/how-to-adjust-the-first-column-to-fill-remaining-space-in-a-word-table) * [How to Keep Paragraphs Inside a Table in ASP.NET Core Word?](https://support.syncfusion.com/kb/article/19678/how-to-keep-paragraphs-inside-a-table-in-aspnet-core-word) +* [How to copy rows from one table to another while preserving formatting in a Word document?](https://support.syncfusion.com/kb/article/20307/how-to-copy-rows-from-one-table-to-another-while-preserving-formatting-in-a-word-document) +* [How to Remove Empty Tables from .NET Core Word Document?](https://support.syncfusion.com/kb/article/20090/how-to-remove-empty-tables-from-net-core-word-document) ## Frequently Asked Questions diff --git a/Document-Processing/Word/Word-Library/NET/Working-with-Word-document.md b/Document-Processing/Word/Word-Library/NET/Working-with-Word-document.md index f82a1aad5..e1348fe86 100644 --- a/Document-Processing/Word/Word-Library/NET/Working-with-Word-document.md +++ b/Document-Processing/Word/Word-Library/NET/Working-with-Word-document.md @@ -442,6 +442,7 @@ You can download a complete working sample from [GitHub](https://github.com/Sync N> 1. The word to PDF layout engine is used for updating the page count in word document. Due to its limitations, it may result in an incorrect page count and the execution of this process may take some time. N> 2. In ASP.NET Core and Xamarin platforms, to update page count in a Word document we recommend you to use 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) as a reference in your application to update page count in a Word document. +N> 3. DocIO uses the Word-to-PDF layout engine to update page count. If the required fonts are missing in the environment, alternate fonts are used, which may affect accuracy. [Ensure](https://support.syncfusion.com/kb/article/6821/check-whether-fonts-in-word-document-are-available-in-machine-for-pdf-or-image-conversion) all fonts used in the input document are available for a correct page count. ### Adding Custom Document properties @@ -1094,6 +1095,7 @@ You can download a complete working sample from [GitHub](https://github.com/Sync * [How to copy style between Word documents](https://support.syncfusion.com/kb/article/17738/how-to-copy-style-between-word-documents) * [Why it is not possible to access the Word document contents page by page?](https://support.syncfusion.com/kb/article/18815/why-it-is-not-possible-to-access-the-word-document-contents-page-by-page) * [How to generate and insert a QR code in a Word Document?](https://support.syncfusion.com/kb/article/19794/how-to-generate-and-insert-a-qr-code-in-a-word-document) +* [How to Remove Empty Tables from .NET Core Word Document?](https://support.syncfusion.com/kb/article/20090/how-to-remove-empty-tables-from-net-core-word-document) ## Frequently Asked Questions diff --git a/Document-Processing/Word/Word-Library/NET/convert-markdown-to-word-document-in-csharp.md b/Document-Processing/Word/Word-Library/NET/convert-markdown-to-word-document-in-csharp.md index 47884534e..0404b8bed 100644 --- a/Document-Processing/Word/Word-Library/NET/convert-markdown-to-word-document-in-csharp.md +++ b/Document-Processing/Word/Word-Library/NET/convert-markdown-to-word-document-in-csharp.md @@ -10,6 +10,9 @@ documentation: UG Markdown is a lightweight markup language that adds formatting elements to plain text documents. The .NET Word (DocIO) library supports the conversion of Markdown to Word document and vice versa, which mostly follows the CommonMark specification and GitHub-flavored syntax. +To quickly start converting a Word document to Markdown and vice versa, please check out this video: +{% youtube "https://www.youtube.com/watch?v=7iMVgVKXRdU" %} + ## Assemblies and NuGet packages required Refer to the following links for assemblies and NuGet packages required based on platforms to convert a Markdown file to a Word document using the .NET Word Library (DocIO). @@ -64,6 +67,9 @@ You can download a complete working sample from [GitHub](https://github.com/Sync T> You can also save the markdown file as [HTML](https://help.syncfusion.com/document-processing/word/word-library/net/html), [PDF](https://help.syncfusion.com/document-processing/word/conversions/word-to-pdf/net/word-to-pdf), and [Image](https://help.syncfusion.com/document-processing/word/conversions/word-to-image/net/word-to-image). +N> 1. Hook the event handler before opening a Word document as per the above code example. +N> 2. In Markdown to Word conversion, SVG or invalid images are replaced with a red "X" image instead of the original image. + ## Customize image data The .NET Word (DocIO) library provides a [ImageNodeVisited](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.SaveOptions.html#Syncfusion_DocIO_DLS_SaveOptions_ImageNodeVisited) event, which customizes image data while importing a Markdown file. Implement the logic to customize the image data by using this [ImageNodeVisited](https://help.syncfusion.com/cr/document-processing/Syncfusion.DocIO.DLS.SaveOptions.html#Syncfusion_DocIO_DLS_SaveOptions_ImageNodeVisited) event. diff --git a/Document-Processing/Word/Word-Library/NET/convert-word-document-to-markdown-in-csharp.md b/Document-Processing/Word/Word-Library/NET/convert-word-document-to-markdown-in-csharp.md index 37055595b..c604267a4 100644 --- a/Document-Processing/Word/Word-Library/NET/convert-word-document-to-markdown-in-csharp.md +++ b/Document-Processing/Word/Word-Library/NET/convert-word-document-to-markdown-in-csharp.md @@ -10,6 +10,9 @@ documentation: UG Markdown is a lightweight markup language that adds formatting elements to plain text documents. The .NET Word (DocIO) library supports the conversion of a Word document to a Markdown file, which mostly follows the CommonMark specification and GitHub-flavored syntax. +To quickly start converting a Word document to Markdown and vice versa, please check out this video: +{% youtube "https://www.youtube.com/watch?v=7iMVgVKXRdU" %} + ## Assemblies and NuGet packages required Refer to the following links for assemblies and NuGet packages required based on platforms to convert a Word document to a Markdown file using the .NET Word Library (DocIO). diff --git a/Document-Processing/Word/Word-Library/NET/faqs/html-and-epub-conversions-faqs.md b/Document-Processing/Word/Word-Library/NET/faqs/html-and-epub-conversions-faqs.md index b5399a890..9306bf8f9 100644 --- a/Document-Processing/Word/Word-Library/NET/faqs/html-and-epub-conversions-faqs.md +++ b/Document-Processing/Word/Word-Library/NET/faqs/html-and-epub-conversions-faqs.md @@ -131,3 +131,32 @@ When using AppendHtml(), the first paragraph in the HTML string is appended to t Refer to the image below: The HTML contains three paragraphs, but in the resulting Word document, the first paragraph is appended to the existing paragraph in the document.  + +## Why do multi-column layouts in Word documents not appear correctly in HTML after conversion? + +When converting a Word document with multiple columns to HTML using Microsoft Word or Syncfusion DocIO, the content appears in a single column. This is expected behavior because HTML does not natively support multi-column layouts. + +## How to apply custom fonts and sizes to mathematical equations in a Word document using DocIO? + +In Microsoft Word, customizing fonts and sizes for mathematical equations can be tricky. When you apply changes to the whole equation, they may not affect all parts as expected. This happens because Word applies changes to the equation container, not the individual parts. + +You can customize fonts and sizes for specific parts, like variables (e.g., "A"). However, symbols like parentheses or brackets adjust automatically based on the equation's content and cannot have their font properties directly changed. + +With DocIO, you can programmatically set fonts and sizes for variables and letters in an equation. Keep in mind, symbols like parentheses or special characters are dynamic and will adjust automatically, so their fonts can't be directly customized. + +## Why does a URL-referenced image show as a red X after appending HTML? + +Images referenced by URLs are not imported automatically in the Word document. To import them, handle the ImageNodeVisited event to download images from the URLs during HTML processing. +For a detailed example, refer to the [article](https://support.syncfusion.com/kb/article/11339/how-to-get-image-from-url-while-opening-html-in-aspnet-core-word?isInternalRefresh=False). + +## How to preserve `||||||||||||||