1016280-ugm: Added missing details in PDF library.

Author: sameerkhan001

Document-Processing/PDF/Conversions/HTML-To-PDF/NET/Convert-HTML-to-PDF-in-Windows-Server.md

@@ -0,0 +1,97 @@
+---
+title: Convert HTML to PDF on the Windows Server | Syncfusion
+description: Learn how to convert HTML to PDF on a Windows Server using IIS Manager with clear and simple guidance.
+platform: document-processing
+control: PDF
+documentation: UG
+keywords: create pdf on windows server, generate pdf on windows server, syncfusion html to pdf, host pdf converter in iis
+---
+
+# Convert HTML to PDF on the Windows Server using IIS Manager
+
+The Syncfusion<sup>&reg;</sup> HTML to PDF converter is a .NET library for converting webpages, SVG, MHTML, and HTML to PDF using C#. Using this library, convert HTML to PDF document on the Windows Server using IIS Manager.
+
+## Steps to convert HTML to PDF on the windows server using IIS manager
+
+Step 1: Create a new C# ASP.NET Web Application (.NET Framework) project.
+![Create ASP.NET MVC application](htmlconversion_images/aspnetmvc1.png)
+
+Step 2: In the Create a new ASP.NET Web Application window, choose the MVC template and click Next to proceed.
+![Configuration window](htmlconversion_images/aspnetmvc3.png)
+
+Step 3: Install [Syncfusion.HtmlToPdfConverter.Net.Windows](https://www.nuget.org/packages/Syncfusion.HtmlToPdfConverter.Net.Windows) NuGet package as reference to your .NET Standard applications from [NuGet.org](https://www.nuget.org/).
+![NuGet Package](htmlconversion_images/nuget-package-window.png)
+
+Step 4: Include the following namespaces in the HomeController.cs file.
+
+{% highlight c# tabtitle="C#" %}
+
+using Syncfusion.Pdf;
+using Syncfusion.HtmlConverter;
+using System.IO;
+
+{% endhighlight %}
+
+Step 5: Add a new button in the Index.cshtml as shown below.
+
+{% highlight c# tabtitle="C#" %}
+
+@{Html.BeginForm("ExportToPDF", "Home", FormMethod.Post);
+    {
+        <div>
+            <input type="submit" value="Convert PDF" style="width:150px;height:27px" />
+        </div>
+    }
+    Html.EndForm();
+ }
+
+{% endhighlight %}
+
+Step 6: Add a new action method named ExportToPDF in HomeController.cs and include the below code example to convert HTML to PDF document using [Convert](https://help.syncfusion.com/cr/document-processing/Syncfusion.HtmlConverter.HtmlToPdfConverter.html#Syncfusion_HtmlConverter_HtmlToPdfConverter_Convert_System_String_) method in [HtmlToPdfConverter](https://help.syncfusion.com/cr/document-processing/Syncfusion.HtmlConverter.HtmlToPdfConverter.html) class.
+
+{% highlight c# tabtitle="C#" %}
+
+//Initialize HTML to PDF converter.
+HtmlToPdfConverter htmlConverter = new HtmlToPdfConverter();
+//Convert URL to PDF document.
+PdfDocument document = htmlConverter.Convert("https://www.syncfusion.com");
+//Create memory stream.
+MemoryStream stream = new MemoryStream();
+//Save the document to memory stream.
+document.Save(stream);
+document.Close(true);
+return File(stream.ToArray(), System.Net.Mime.MediaTypeNames.Application.Pdf, "HTML-to-PDF.pdf");
+
+{% endhighlight %}
+
+Step 7: Run the project and verify that the HTML‑to‑PDF conversion functions correctly in the local environment.
+
+## Publish the project to a Windows Server using IIS
+
+Step 1: Publish the project to a local folder by right‑clicking the project, selecting **Publish**, choosing the **Folder** option, and clicking **Next**.
+![IIS Folder](htmlconversion_images/IIS-Folder.png)
+
+Step 2: Provide the folder path where the project should be published.
+![IIS Folder Path](htmlconversion_images/IIS-Browser.png)
+
+Step 3: After creating the publish profile, Visual Studio opens the Publish dashboard. Review the target location, configuration, and other settings, and adjust them if necessary. Once everything looks correct, click **Publish** to deploy the application to the selected destination.
+![IIS Publish](htmlconversion_images/IIS-Publish.png)
+
+Step 4: It will generate and publish all necessary files to the local publish directory.
+![IIS Local Folder Path](htmlconversion_images/IIS-localfolder.png)
+
+Step 5: Copy the published output folder to the server and host the application in IIS.
+i.Open **IIS Manager** on the server and create a new website.
+
+ii.Enter a **site name** and select the **physical path** that points to the published output folder on the server.
+![IIS Website](htmlconversion_images/IIS-Website.png)
+
+iii. Obtain the server’s IP address after adding the website in the local IIS server.
+
+iv. From your local computer, browse the website using the server’s IP address and port number. Once the site loads successfully, export the webpage to PDF.
+![IIS Browser](htmlconversion_images/IIS-RunBrowser.png)
+
+A complete working sample is available for download from [GitHub](https://github.com/SyncfusionExamples/html-to-pdf-csharp-examples/tree/master/ASP.NET%20Core).
+
+Click the button to convert the Syncfusion<sup>&reg;</sup> webpage into a PDF document. The generated PDF will appear as shown below.
+![IIS Output document](htmlconversion_images/IIS-Output.png)

Document-Processing/PDF/Conversions/HTML-To-PDF/NET/htmlconversion_images/IIS-Browser.png

@@ -1560,22 +1560,44 @@ N> We have option to exclude the default Blink binaries from the installation pa
 
 ## How to Exclude BlinkBinaries or Runtime Files in Build or Deployment
 
-The runtime files, or blink binaries, will be copied into a bin or published folder while building and publishing the application.
-By including the <ExcludeAssets>native</ExcludeAssets> option in the package reference of the csproj file, you can exclude the runtime files or blink binaries from being copied into the bin or publish folder while building and publishing the application. But you need to place the BlinkBinaries in the server disk and set the BlinkPath in the BlinkConverterSettings to perform the conversion. 
+When you build or publish the application, the Syncfusion HTML‑to‑PDF converter automatically copies the Blink runtime files (BlinkBinaries) into the <i>bin</i> or <i>publish</i> output folder. These binaries are required for HTML‑to‑PDF conversion at runtime. However, in certain deployment scenarios—such as reducing the deployment size or using a shared/system‑installed Chromium—you can exclude these files and instead provide the Blink binaries manually on the host machine.
+
+To exclude BlinkBinaries during the build process, configure your project file depending on whether you are using <b>.NET Core/.NET or .NET Framework</b>. 
 
-N> Using this approach, you can reduce the deployment size on your own servers. 
+<b>Exclude BlinkBinaries in .NET Core</b>
+You can prevent runtime files from being included by restricting the package to <b>compile-only</b> assets using the <b>IncludeAssets</b> tag in the <b>PackageReference</b>. This stops all Blink runtime binaries from being copied into the output folder.
 
 Refer to the following package reference:
 
 {% tabs %}
 {% highlight C# %}
 
 <ItemGroup>
-    <PackageReference Include="Syncfusion.HtmlToPdfConverter.Net.Windows" Version="31.1.23">
-      <ExcludeAssets>native</ExcludeAssets>
+ 	<PackageReference Include="Syncfusion.HtmlToPdfConverter.Net.Windows" Version="32.1.21">
+        <IncludeAssets>compile;runtime</IncludeAssets>
     </PackageReference>
 </ItemGroup>
 
 {% endhighlight %}
 {% endtabs %}
 
+By using <b>IncludeAssets="compile"</b>, only the required compile-time metadata is included, and all runtime dependencies (BlinkBinaries) are excluded from the final build or publish output.
+
+N> If you exclude runtime files, you must manually place BlinkBinaries on the server and configure BlinkPath in BlinkConverterSettings for conversion to work.
+
+<b>Exclude BlinkBinaries in .NET Framework Projects</b>
+
+For .NET Framework applications, Blink runtime files are included through a .targets file referenced in the project.
+To exclude BlinkBinaries, simply remove this import entry.
+
+{% tabs %}
+{% highlight C# %}
+
+<Import Project="packages\Syncfusion.HtmlToPdfConverter.AspNet.Mvc5.32.1.20\build\net462\Syncfusion.HtmlToPdfConverter.AspNet.Mvc5.targets" Condition="Exists('packages\Syncfusion.HtmlToPdfConverter.AspNet.Mvc5.32.1.20\build\net462\Syncfusion.HtmlToPdfConverter.AspNet.Mvc5.targets')" />
+
+{% endhighlight %}
+{% endtabs %}
+
+Removing this line prevents the Syncfusion<sup>&reg;</sup> build targets from copying BlinkBinaries and other runtime files into your bin folder during build or publish.
+
+N> By excluding BlinkBinaries, you can significantly reduce the size of your deployment package, especially in server environments where disk usage and deployment time matter.